From 3bbf6d6a1bae3504e69f3a714ce4c4e12d83ef3d Mon Sep 17 00:00:00 2001 From: hector-ae21 Date: Sun, 18 Oct 2026 16:45:56 +0200 Subject: [PATCH 1/2] feat(docs): add the rup-flow documentation site Versioned MkDocs Material site that follows the structure, tooling and styling of the octoform documentation, in the colors of the rup-flow logo. It documents the free edition completely and describes rup-flow Pro at feature level only, so nothing there can recreate a Pro capability. The documented free version is declared in package.json (rupFlow.version) and drives the release line, the immutable publication tags and the version selector. --- .editorconfig | 13 + .gitattributes | 7 + .github/CODEOWNERS | 6 + .github/ISSUE_TEMPLATE/config.yml | 6 + .github/ISSUE_TEMPLATE/documentation.yml | 36 + .github/PULL_REQUEST_TEMPLATE.md | 15 + .github/dependabot.yml | 32 + .github/workflows/publish.yml | 239 ++ .github/workflows/pull-request.yml | 71 + .gitignore | 4 + .htmlvalidate.json | 22 + .markdownlint-cli2.yaml | 23 + CODE_OF_CONDUCT.md | 28 + CONTRIBUTING.md | 49 + README.md | 65 + SECURITY.md | 18 + THIRD_PARTY_NOTICES.md | 11 + cspell.json | 69 + docs/architecture/delivery.md | 39 + docs/architecture/editions.md | 60 + docs/architecture/index.md | 78 + docs/architecture/trust-and-data.md | 42 + docs/assets/brand/rup-flow-favicon.png | Bin 0 -> 5575 bytes docs/assets/brand/rup-flow-logo.png | Bin 0 -> 5575 bytes docs/assets/brand/rup-flow-mark.png | Bin 0 -> 5575 bytes .../diagrams/catalogue/analysis-classes.svg | 229 ++ .../diagrams/catalogue/collaboration.svg | 191 + docs/assets/diagrams/catalogue/components.svg | 87 + docs/assets/diagrams/catalogue/data-model.svg | 1 + docs/assets/diagrams/catalogue/deployment.svg | 13 + .../diagrams/catalogue/design-classes.svg | 331 ++ .../catalogue/domain-model-simple.svg | 1 + .../diagrams/catalogue/domain-model.svg | 97 + .../diagrams/catalogue/entity-states.svg | 1 + docs/assets/diagrams/catalogue/sequence.svg | 69 + .../diagrams/catalogue/specification.svg | 1 + .../diagrams/catalogue/use-case-overview.svg | 45 + .../diagrams/catalogue/use-cases-customer.svg | 23 + docs/assets/diagrams/catalogue/wireframes.svg | 1 + docs/assets/diagrams/editions-overlay.svg | 1 + docs/assets/diagrams/sources/_theme.iuml | 93 + .../diagrams/sources/editions-overlay.puml | 31 + .../diagrams/sources/system-context.puml | 26 + docs/assets/diagrams/system-context.svg | 1 + docs/assets/explorer/explorer-overview.png | Bin 0 -> 103300 bytes docs/assets/javascripts/navigation.js | 21 + docs/assets/mermaid/collaboration.svg | 1049 ++++++ docs/assets/mermaid/components.svg | 119 + docs/assets/mermaid/data-model.svg | 951 +++++ docs/assets/mermaid/deployment.svg | 1095 ++++++ docs/assets/mermaid/domain-model-forest.svg | 231 ++ docs/assets/mermaid/domain-model.svg | 231 ++ docs/assets/mermaid/sequence-dark.svg | 91 + docs/assets/mermaid/sequence.svg | 91 + docs/assets/mermaid/specification.svg | 387 ++ docs/assets/mermaid/use-case-overview.svg | 2073 ++++++++++ docs/assets/stylesheets/extra.css | 770 ++++ docs/assets/themes/custom.svg | 97 + docs/assets/themes/dark.svg | 97 + docs/assets/themes/default.svg | 97 + docs/assets/themes/forest.svg | 97 + docs/assets/themes/grape.svg | 97 + docs/assets/themes/high-contrast.svg | 97 + docs/assets/themes/mono.svg | 97 + docs/assets/themes/ocean.svg | 97 + docs/assets/themes/overview.svg | 107 + docs/assets/themes/sunset.svg | 97 + docs/configuration/index.md | 69 + docs/contributing/index.md | 39 + docs/diagrams/analysis-classes.md | 62 + docs/diagrams/conventions.md | 54 + docs/diagrams/domain-model-simple.md | 60 + docs/diagrams/index.md | 108 + docs/diagrams/specification.md | 69 + docs/getting-started/first-documentation.md | 62 + docs/getting-started/how-it-works.md | 54 + docs/getting-started/index.md | 71 + docs/getting-started/installation.md | 67 + docs/guides/document-a-system.md | 50 + docs/guides/index.md | 60 + docs/guides/other-agents.md | 46 + docs/guides/render-and-check.md | 52 + docs/guides/troubleshooting.md | 42 + docs/guides/use-cases.md | 53 + docs/index.md | 151 + docs/pro/code.md | 47 + docs/pro/compare.md | 98 + docs/pro/documentation-set.md | 40 + docs/pro/get-pro.md | 53 + docs/pro/index.md | 89 + docs/pro/license-and-support.md | 34 + docs/pro/packs-and-agents.md | 42 + docs/pro/themes-and-explorer.md | 58 + docs/reference/cli.md | 113 + docs/reference/folder-structure.md | 51 + docs/reference/front-matter.md | 55 + docs/reference/index.md | 60 + docs/reference/provenance.md | 38 + docs/releases/changelog.md | 125 + docs/releases/index.md | 57 + docs/releases/updating.md | 45 + docs/releases/versioning.md | 51 + mkdocs.yml | 148 + overrides/main.html | 8 + overrides/partials/nav-item.html | 167 + package-lock.json | 3342 +++++++++++++++++ package.json | 35 + pyproject.toml | 14 + requirements.lock | 512 +++ scripts/build.mjs | 24 + scripts/release-version.mjs | 152 + scripts/render-diagrams.mjs | 64 + scripts/resolve-release.mjs | 48 + scripts/scan-secrets.mjs | 41 + scripts/validate-a11y.mjs | 115 + scripts/validate-deployment.mjs | 120 + scripts/validate-links.mjs | 114 + scripts/validate-privacy.mjs | 68 + scripts/validate-release.mjs | 45 + scripts/verify-pages.mjs | 45 + scripts/verify.mjs | 34 + test/release-version.test.mjs | 145 + test/validate-deployment.test.mjs | 112 + test/workflow-boundaries.test.mjs | 27 + 124 files changed, 17869 insertions(+) create mode 100644 .editorconfig create mode 100644 .gitattributes create mode 100644 .github/CODEOWNERS create mode 100644 .github/ISSUE_TEMPLATE/config.yml create mode 100644 .github/ISSUE_TEMPLATE/documentation.yml create mode 100644 .github/PULL_REQUEST_TEMPLATE.md create mode 100644 .github/dependabot.yml create mode 100644 .github/workflows/publish.yml create mode 100644 .github/workflows/pull-request.yml create mode 100644 .gitignore create mode 100644 .htmlvalidate.json create mode 100644 .markdownlint-cli2.yaml create mode 100644 CODE_OF_CONDUCT.md create mode 100644 CONTRIBUTING.md create mode 100644 README.md create mode 100644 SECURITY.md create mode 100644 THIRD_PARTY_NOTICES.md create mode 100644 cspell.json create mode 100644 docs/architecture/delivery.md create mode 100644 docs/architecture/editions.md create mode 100644 docs/architecture/index.md create mode 100644 docs/architecture/trust-and-data.md create mode 100644 docs/assets/brand/rup-flow-favicon.png create mode 100644 docs/assets/brand/rup-flow-logo.png create mode 100644 docs/assets/brand/rup-flow-mark.png create mode 100644 docs/assets/diagrams/catalogue/analysis-classes.svg create mode 100644 docs/assets/diagrams/catalogue/collaboration.svg create mode 100644 docs/assets/diagrams/catalogue/components.svg create mode 100644 docs/assets/diagrams/catalogue/data-model.svg create mode 100644 docs/assets/diagrams/catalogue/deployment.svg create mode 100644 docs/assets/diagrams/catalogue/design-classes.svg create mode 100644 docs/assets/diagrams/catalogue/domain-model-simple.svg create mode 100644 docs/assets/diagrams/catalogue/domain-model.svg create mode 100644 docs/assets/diagrams/catalogue/entity-states.svg create mode 100644 docs/assets/diagrams/catalogue/sequence.svg create mode 100644 docs/assets/diagrams/catalogue/specification.svg create mode 100644 docs/assets/diagrams/catalogue/use-case-overview.svg create mode 100644 docs/assets/diagrams/catalogue/use-cases-customer.svg create mode 100644 docs/assets/diagrams/catalogue/wireframes.svg create mode 100644 docs/assets/diagrams/editions-overlay.svg create mode 100644 docs/assets/diagrams/sources/_theme.iuml create mode 100644 docs/assets/diagrams/sources/editions-overlay.puml create mode 100644 docs/assets/diagrams/sources/system-context.puml create mode 100644 docs/assets/diagrams/system-context.svg create mode 100644 docs/assets/explorer/explorer-overview.png create mode 100644 docs/assets/javascripts/navigation.js create mode 100644 docs/assets/mermaid/collaboration.svg create mode 100644 docs/assets/mermaid/components.svg create mode 100644 docs/assets/mermaid/data-model.svg create mode 100644 docs/assets/mermaid/deployment.svg create mode 100644 docs/assets/mermaid/domain-model-forest.svg create mode 100644 docs/assets/mermaid/domain-model.svg create mode 100644 docs/assets/mermaid/sequence-dark.svg create mode 100644 docs/assets/mermaid/sequence.svg create mode 100644 docs/assets/mermaid/specification.svg create mode 100644 docs/assets/mermaid/use-case-overview.svg create mode 100644 docs/assets/stylesheets/extra.css create mode 100644 docs/assets/themes/custom.svg create mode 100644 docs/assets/themes/dark.svg create mode 100644 docs/assets/themes/default.svg create mode 100644 docs/assets/themes/forest.svg create mode 100644 docs/assets/themes/grape.svg create mode 100644 docs/assets/themes/high-contrast.svg create mode 100644 docs/assets/themes/mono.svg create mode 100644 docs/assets/themes/ocean.svg create mode 100644 docs/assets/themes/overview.svg create mode 100644 docs/assets/themes/sunset.svg create mode 100644 docs/configuration/index.md create mode 100644 docs/contributing/index.md create mode 100644 docs/diagrams/analysis-classes.md create mode 100644 docs/diagrams/conventions.md create mode 100644 docs/diagrams/domain-model-simple.md create mode 100644 docs/diagrams/index.md create mode 100644 docs/diagrams/specification.md create mode 100644 docs/getting-started/first-documentation.md create mode 100644 docs/getting-started/how-it-works.md create mode 100644 docs/getting-started/index.md create mode 100644 docs/getting-started/installation.md create mode 100644 docs/guides/document-a-system.md create mode 100644 docs/guides/index.md create mode 100644 docs/guides/other-agents.md create mode 100644 docs/guides/render-and-check.md create mode 100644 docs/guides/troubleshooting.md create mode 100644 docs/guides/use-cases.md create mode 100644 docs/index.md create mode 100644 docs/pro/code.md create mode 100644 docs/pro/compare.md create mode 100644 docs/pro/documentation-set.md create mode 100644 docs/pro/get-pro.md create mode 100644 docs/pro/index.md create mode 100644 docs/pro/license-and-support.md create mode 100644 docs/pro/packs-and-agents.md create mode 100644 docs/pro/themes-and-explorer.md create mode 100644 docs/reference/cli.md create mode 100644 docs/reference/folder-structure.md create mode 100644 docs/reference/front-matter.md create mode 100644 docs/reference/index.md create mode 100644 docs/reference/provenance.md create mode 100644 docs/releases/changelog.md create mode 100644 docs/releases/index.md create mode 100644 docs/releases/updating.md create mode 100644 docs/releases/versioning.md create mode 100644 mkdocs.yml create mode 100644 overrides/main.html create mode 100644 overrides/partials/nav-item.html create mode 100644 package-lock.json create mode 100644 package.json create mode 100644 pyproject.toml create mode 100644 requirements.lock create mode 100644 scripts/build.mjs create mode 100644 scripts/release-version.mjs create mode 100644 scripts/render-diagrams.mjs create mode 100644 scripts/resolve-release.mjs create mode 100644 scripts/scan-secrets.mjs create mode 100644 scripts/validate-a11y.mjs create mode 100644 scripts/validate-deployment.mjs create mode 100644 scripts/validate-links.mjs create mode 100644 scripts/validate-privacy.mjs create mode 100644 scripts/validate-release.mjs create mode 100644 scripts/verify-pages.mjs create mode 100644 scripts/verify.mjs create mode 100644 test/release-version.test.mjs create mode 100644 test/validate-deployment.test.mjs create mode 100644 test/workflow-boundaries.test.mjs diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 0000000..6fe3ca1 --- /dev/null +++ b/.editorconfig @@ -0,0 +1,13 @@ +root = true + +[*] +charset = utf-8 +end_of_line = lf +insert_final_newline = true +indent_style = space +indent_size = 2 +trim_trailing_whitespace = true + +[*.md] +trim_trailing_whitespace = false + diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..73f1b24 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,7 @@ +* text=auto eol=lf +*.svg text eol=lf +*.yml text eol=lf +*.yaml text eol=lf +*.json text eol=lf +*.lock text eol=lf +*.png binary diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS new file mode 100644 index 0000000..1365db6 --- /dev/null +++ b/.github/CODEOWNERS @@ -0,0 +1,6 @@ +* @hector-ae21 +/.github/ @hector-ae21 +/mkdocs.yml @hector-ae21 +/overrides/ @hector-ae21 +/scripts/ @hector-ae21 + diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..020a32e --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,6 @@ +blank_issues_enabled: false +contact_links: + - name: Security vulnerability + url: https://github.com/hector-ae21/rup-flow/security/advisories/new + about: Report vulnerabilities and exposed credentials privately. + diff --git a/.github/ISSUE_TEMPLATE/documentation.yml b/.github/ISSUE_TEMPLATE/documentation.yml new file mode 100644 index 0000000..98ac112 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/documentation.yml @@ -0,0 +1,36 @@ +name: Documentation problem +description: Report missing, inaccurate, unclear, or unsafe rup-flow documentation. +title: "docs: " +labels: + - documentation +body: + - type: markdown + attributes: + value: Thank you for helping make rup-flow easier and safer to use. + - type: input + id: page + attributes: + label: Page or section + description: Link to the affected page when available. + validations: + required: true + - type: input + id: version + attributes: + label: rup-flow version + placeholder: 0.3 + validations: + required: true + - type: textarea + id: problem + attributes: + label: What is wrong or missing? + description: Do not include tokens, private repository names, or sensitive output. + validations: + required: true + - type: textarea + id: expected + attributes: + label: What would help? + validations: + required: true diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 0000000..382cddd --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,15 @@ +# Documentation pull request + +## What changes, and why + +## Version applicability + +## How it was verified + +## Checklist + +- [ ] Content describes released behavior or is clearly identified as roadmap material +- [ ] Procedures state prerequisites, permissions, result, and recovery +- [ ] Examples contain no real tokens or private repository data +- [ ] `npm run verify` passes locally +- [ ] Light/dark and mobile/desktop rendering were inspected diff --git a/.github/dependabot.yml b/.github/dependabot.yml new file mode 100644 index 0000000..89a2b69 --- /dev/null +++ b/.github/dependabot.yml @@ -0,0 +1,32 @@ +version: 2 +updates: + - package-ecosystem: github-actions + directory: / + schedule: + interval: weekly + labels: + - dependencies + - documentation + - package-ecosystem: npm + directory: / + schedule: + interval: weekly + labels: + - dependencies + - documentation + groups: + documentation-tooling: + patterns: + - "*" + - package-ecosystem: pip + directory: / + schedule: + interval: weekly + labels: + - dependencies + - documentation + groups: + documentation-platform: + patterns: + - "*" + diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml new file mode 100644 index 0000000..9e24b44 --- /dev/null +++ b/.github/workflows/publish.yml @@ -0,0 +1,239 @@ +name: Publish versioned documentation +run-name: Publish documentation from ${{ github.sha }} + +on: + push: + branches: + - v0.x + workflow_dispatch: + +concurrency: + group: documentation-release + cancel-in-progress: false + +env: + NO_MKDOCS_2_WARNING: "true" + +jobs: + build: + name: Build immutable documentation + runs-on: ubuntu-latest + timeout-minutes: 30 + permissions: + contents: write + pages: write + outputs: + application_version: ${{ steps.release.outputs.application_version }} + application_line: ${{ steps.release.outputs.application_line }} + publication_tag: ${{ steps.release.outputs.publication_tag }} + publication_version: ${{ steps.release.outputs.publication_version }} + publish_documentation_line: ${{ steps.release.outputs.publish_documentation_line }} + steps: + - name: Check out complete history + uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 + with: + fetch-depth: 0 + + - name: Set up Python + uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 + with: + python-version: "3.13" + cache: pip + cache-dependency-path: requirements.lock + + - name: Set up Node.js + uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 + with: + node-version: "24" + cache: npm + + - name: Install Python dependencies + run: python -m pip install --require-hashes -r requirements.lock + + - name: Install Node.js dependencies + run: npm ci + + - name: Resolve documentation release + id: release + run: node scripts/resolve-release.mjs "$GITHUB_SHA" + + - name: Authorize manual recovery source + if: github.event_name == 'workflow_dispatch' + env: + REUSED_RELEASE: ${{ steps.release.outputs.reused }} + SOURCE_REF: ${{ github.ref }} + run: | + if [ "$SOURCE_REF" != "refs/heads/v0.x" ] && [ "$REUSED_RELEASE" != "true" ]; then + echo "Manual publication must target v0.x or an existing documentation release tag." >&2 + exit 1 + fi + + - name: Validate release identity + env: + APPLICATION_VERSION: ${{ steps.release.outputs.application_version }} + PUBLICATION_VERSION: ${{ steps.release.outputs.publication_version }} + run: node scripts/validate-release.mjs "$PUBLICATION_VERSION" "$APPLICATION_VERSION" + + - name: Build documentation + run: npm run build + + - name: Configure documentation publisher + run: | + git config user.name "github-actions[bot]" + git config user.email "41898282+github-actions[bot]@users.noreply.github.com" + + - name: Create immutable source tag + if: steps.release.outputs.reused == 'false' + env: + APPLICATION_VERSION: ${{ steps.release.outputs.application_version }} + PUBLICATION_TAG: ${{ steps.release.outputs.publication_tag }} + PUBLICATION_VERSION: ${{ steps.release.outputs.publication_version }} + run: | + git tag --annotate "$PUBLICATION_TAG" "$GITHUB_SHA" \ + --message "rup-flow documentation publication $PUBLICATION_VERSION for rup-flow $APPLICATION_VERSION" + git push origin "refs/tags/$PUBLICATION_TAG" + + - name: Fetch published documentation history + if: steps.release.outputs.publish_documentation_line == 'true' + run: git fetch origin gh-pages:gh-pages + + - name: Convert exact patch paths to release-line redirects + if: steps.release.outputs.publish_documentation_line == 'true' + env: + APPLICATION_LINE: ${{ steps.release.outputs.application_line }} + APPLICATION_VERSION: ${{ steps.release.outputs.application_version }} + run: | + git show gh-pages:versions.json > "$RUNNER_TEMP/versions.json" + node --input-type=module --eval ' + import { readFileSync, writeFileSync } from "node:fs"; + import { collectPatchDocumentationPaths } from "./scripts/release-version.mjs"; + const versions = JSON.parse(readFileSync(process.argv[1], "utf8")); + const paths = collectPatchDocumentationPaths(versions, process.argv[2]); + const versionLines = paths.versions.join("\n"); + writeFileSync(process.argv[3], versionLines.length === 0 ? "" : `${versionLines}\n`); + for (const redirect of paths.redirects) console.log(redirect); + ' "$RUNNER_TEMP/versions.json" "$APPLICATION_LINE" \ + "$RUNNER_TEMP/legacy-patch-versions.txt" \ + > "$RUNNER_TEMP/legacy-patch-paths.txt" + if ! grep --fixed-strings --line-regexp --quiet \ + "$APPLICATION_VERSION" "$RUNNER_TEMP/legacy-patch-paths.txt"; then + echo "$APPLICATION_VERSION" >> "$RUNNER_TEMP/legacy-patch-paths.txt" + fi + sort --unique "$RUNNER_TEMP/legacy-patch-paths.txt" \ + --output "$RUNNER_TEMP/legacy-patch-paths.txt" + while IFS= read -r version; do + if [ -n "$version" ]; then + mike delete --branch gh-pages "$version" + fi + done < "$RUNNER_TEMP/legacy-patch-versions.txt" + + - name: Publish documented rup-flow line and redirect aliases + if: steps.release.outputs.publish_documentation_line == 'true' + env: + APPLICATION_LINE: ${{ steps.release.outputs.application_line }} + run: | + mapfile -t PATCH_REDIRECTS < "$RUNNER_TEMP/legacy-patch-paths.txt" + mike deploy --branch gh-pages --alias-type redirect --update-aliases \ + "$APPLICATION_LINE" "${PATCH_REDIRECTS[@]}" latest stable + mike set-default --branch gh-pages latest + git push origin gh-pages:gh-pages + + - name: Export the pushed Pages tree + if: steps.release.outputs.publish_documentation_line == 'true' + run: | + git fetch origin gh-pages + mkdir --parents "$RUNNER_TEMP/rup-pages" + git archive origin/gh-pages | tar --extract --directory "$RUNNER_TEMP/rup-pages" + + - name: Validate the pushed Pages tree + if: steps.release.outputs.publish_documentation_line == 'true' + env: + APPLICATION_LINE: ${{ steps.release.outputs.application_line }} + run: | + mapfile -t PATCH_REDIRECTS < "$RUNNER_TEMP/legacy-patch-paths.txt" + node scripts/validate-deployment.mjs site "$RUNNER_TEMP/rup-pages" \ + "$APPLICATION_LINE" "${PATCH_REDIRECTS[@]}" latest stable + + - name: Configure GitHub Pages + if: steps.release.outputs.publish_documentation_line == 'true' + uses: actions/configure-pages@45bfe0192ca1faeb007ade9deae92b16b8254a0d + + - name: Upload GitHub Pages artifact + if: steps.release.outputs.publish_documentation_line == 'true' + uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 + with: + path: ${{ runner.temp }}/rup-pages + + deploy: + name: Deploy GitHub Pages + needs: build + if: needs.build.outputs.publish_documentation_line == 'true' + runs-on: ubuntu-latest + timeout-minutes: 10 + permissions: + actions: read + contents: read + id-token: write + pages: write + environment: + name: github-pages + url: ${{ steps.deployment.outputs.page_url }} + outputs: + page_url: ${{ steps.deployment.outputs.page_url }} + steps: + - name: Deploy documentation + id: deployment + uses: actions/deploy-pages@368f82528645a54fb793d4d04e342629a3f51346 + + release: + name: Verify and record documentation release + needs: + - build + - deploy + if: >- + always() && + needs.build.result == 'success' && + (needs.deploy.result == 'success' || needs.deploy.result == 'skipped') + runs-on: ubuntu-latest + timeout-minutes: 15 + permissions: + contents: write + steps: + - name: Check out released sources + uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 + + - name: Set up Node.js + uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 + with: + node-version: "24" + + - name: Verify public version and aliases + if: needs.build.outputs.publish_documentation_line == 'true' + env: + APPLICATION_LINE: ${{ needs.build.outputs.application_line }} + APPLICATION_VERSION: ${{ needs.build.outputs.application_version }} + PAGE_URL: ${{ needs.deploy.outputs.page_url }} + run: | + node scripts/verify-pages.mjs "$PAGE_URL" "$APPLICATION_LINE" \ + "$APPLICATION_VERSION" latest stable + + - name: Create GitHub Release + env: + APPLICATION_VERSION: ${{ needs.build.outputs.application_version }} + APPLICATION_LINE: ${{ needs.build.outputs.application_line }} + PUBLICATION_TAG: ${{ needs.build.outputs.publication_tag }} + PUBLICATION_VERSION: ${{ needs.build.outputs.publication_version }} + PUBLISH_DOCUMENTATION_LINE: ${{ needs.build.outputs.publish_documentation_line }} + GH_TOKEN: ${{ github.token }} + run: | + if gh release view "$PUBLICATION_TAG" > /dev/null 2>&1; then + echo "Release $PUBLICATION_TAG already exists." + else + LATEST_FLAG="--latest=false" + if [ "$PUBLISH_DOCUMENTATION_LINE" = "true" ]; then + LATEST_FLAG="--latest" + fi + gh release create "$PUBLICATION_TAG" --verify-tag --generate-notes \ + "$LATEST_FLAG" \ + --title "Documentation publication $PUBLICATION_VERSION for rup-flow $APPLICATION_LINE (validated with $APPLICATION_VERSION)" + fi diff --git a/.github/workflows/pull-request.yml b/.github/workflows/pull-request.yml new file mode 100644 index 0000000..a9656ca --- /dev/null +++ b/.github/workflows/pull-request.yml @@ -0,0 +1,71 @@ +name: Documentation CI + +on: + pull_request: + workflow_dispatch: + +permissions: + contents: read + +concurrency: + group: docs-ci-${{ github.workflow }}-${{ github.ref }} + cancel-in-progress: true + +env: + NO_MKDOCS_2_WARNING: "true" + +jobs: + verify: + name: Verify documentation + runs-on: ubuntu-latest + timeout-minutes: 20 + steps: + - name: Check out sources + uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 + + - name: Set up Python + uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 + with: + python-version: "3.13" + cache: pip + cache-dependency-path: requirements.lock + + - name: Set up Node.js + uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 + with: + node-version: "24" + cache: npm + + - name: Install Python dependencies + run: python -m pip install --require-hashes -r requirements.lock + + - name: Install Node.js dependencies + run: npm ci + + - name: Install the accessibility browser + run: npx playwright install --with-deps chromium + + - name: Verify documentation + run: npm run verify + + - name: Upload isolated preview + uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a + with: + name: documentation-preview-${{ github.event.pull_request.number || github.run_id }} + path: site + if-no-files-found: error + retention-days: 7 + + dependency-review: + name: Review dependency changes + if: github.event_name == 'pull_request' + runs-on: ubuntu-latest + timeout-minutes: 10 + steps: + - name: Check out sources + uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 + + - name: Review dependency changes + uses: actions/dependency-review-action@a1d282b36b6f3519aa1f3fc636f609c47dddb294 + with: + fail-on-severity: high diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..e5bfd6b --- /dev/null +++ b/.gitignore @@ -0,0 +1,4 @@ +.cache/ +.venv/ +node_modules/ +site/ diff --git a/.htmlvalidate.json b/.htmlvalidate.json new file mode 100644 index 0000000..50d1286 --- /dev/null +++ b/.htmlvalidate.json @@ -0,0 +1,22 @@ +{ + "extends": ["html-validate:recommended"], + "rules": { + "doctype-style": "off", + "attribute-boolean-style": "off", + "element-required-attributes": "off", + "input-attributes": "off", + "long-title": "off", + "no-deprecated-attr": "off", + "no-inline-style": "off", + "no-raw-characters": "off", + "no-trailing-whitespace": "off", + "prefer-native-element": "off", + "require-sri": "off", + "unique-landmark": "off", + "valid-autocomplete": "off", + "valid-id": "off", + "void-style": "off", + "wcag/h30": "off", + "wcag/h32": "off" + } +} diff --git a/.markdownlint-cli2.yaml b/.markdownlint-cli2.yaml new file mode 100644 index 0000000..687eacb --- /dev/null +++ b/.markdownlint-cli2.yaml @@ -0,0 +1,23 @@ +config: + default: true + line-length: false + no-duplicate-heading: + siblings_only: true + single-title: false + code-block-style: false + no-inline-html: + allowed_elements: + - div + - p + - span + - kbd + - sup + - figure + - figcaption + - svg +globs: + - "**/*.md" +ignores: + - "node_modules/**" + - ".venv/**" + - "site/**" diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md new file mode 100644 index 0000000..49cd74d --- /dev/null +++ b/CODE_OF_CONDUCT.md @@ -0,0 +1,28 @@ +# Contributor Covenant Code of Conduct + +## Our pledge + +We pledge to make participation in this project a harassment-free experience +for everyone, regardless of age, body size, visible or invisible disability, +ethnicity, sex characteristics, gender identity and expression, level of +experience, education, socio-economic status, nationality, personal +appearance, race, caste, colour, religion, or sexual identity and orientation. + +## Our standards + +Positive behavior includes empathy, respectful feedback, acceptance of +responsibility, and focus on what is best for the community. Unacceptable +behavior includes harassment, insulting or derogatory comments, publishing +private information, and conduct inappropriate in a professional setting. + +## Enforcement + +Report unacceptable behavior privately through the contact methods in the +[rup-flow security policy](https://github.com/hector-ae21/rup-flow/security/policy). +Project maintainers may remove, edit, or reject contributions and communication +that do not align with this code, and will respect the reporter's privacy. + +## Attribution + +This Code of Conduct is adapted from the +[Contributor Covenant, version 2.1](https://www.contributor-covenant.org/version/2/1/code_of_conduct.html). diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..d96d86b --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,49 @@ +# Contributing + +Thank you for improving the rup-flow documentation. Contributions should make a +procedure easier to follow, a statement more precise or a page easier to find. + +## Before you start + +- Open an issue with the documentation template for anything larger than a + correction. +- Work on a branch from `v0.x` and open a pull request. Do not push to `v0.x`. +- Use [Conventional Commits](https://www.conventionalcommits.org/): + `docs(guides): explain the strict check`. + +## What to write + +- Describe released behaviour of the free edition. Roadmap items are labelled as + such. +- Procedures state prerequisites, the result and how to recover. +- Describe rup-flow Pro at feature level only. A reader must not be able to + recreate a Pro capability from this site: no Pro commands, flags, + configuration keys, templates or step-by-step procedures. +- Examples contain no credentials or private data. + +## Verify locally + +```bash +npm run verify +``` + +It runs the Markdown lint, the spelling check, the release tests, the PlantUML +check, a strict MkDocs build, the HTML, link and privacy validation, and the +accessibility check. CI runs the same command on every pull request. + +## Versions + +`rupFlow.version` in `package.json` is the documented free version; its +`MAJOR.MINOR` must match the release line declared in `docs/releases/index.md`. +Documentation publications are tagged automatically after merge. + +## Style + +- American English, plain words, short sentences. +- One idea per heading; headings describe the content. +- Tables for comparisons, numbered lists for sequences, admonitions sparingly. +- Link text says where the link goes. + +## Conduct and security + +See [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) and [SECURITY.md](SECURITY.md). diff --git a/README.md b/README.md new file mode 100644 index 0000000..b5be8eb --- /dev/null +++ b/README.md @@ -0,0 +1,65 @@ +# rup-flow documentation + +[![Documentation CI](https://img.shields.io/github/actions/workflow/status/hector-ae21/rup-flow-docs/pull-request.yml?branch=v0.x&logo=github&label=documentation%20CI)](https://github.com/hector-ae21/rup-flow-docs/actions/workflows/pull-request.yml) + +Versioned documentation for [rup-flow](https://github.com/hector-ae21/rup-flow), +the skill that turns requirements into RUP documentation with your AI coding +agent. It documents the free edition completely and describes rup-flow Pro at +feature level. + +Read it at . The site is versioned +by the free edition's `MAJOR.MINOR`; each approved publication also gets an +immutable `vMAJOR.MINOR.PATCH` tag and a GitHub release. + +## What is here + +| Path | Content | +| --- | --- | +| `docs/` | The pages: getting started, guides, reference, diagrams, architecture, Pro, releases | +| `mkdocs.yml` | Site structure and theme | +| `overrides/`, `docs/assets/` | Templates, styles, brand and images | +| `scripts/` | Build, release resolution, deployment and quality validation | +| `test/` | Tests of the release and deployment logic | + +## Work on the documentation + +You need Python 3.13 and Node.js 24.8 or newer. + +```bash +python -m venv .venv +.venv/bin/python -m pip install --require-hashes -r requirements.lock +npm ci +npm run verify +``` + +On Windows the interpreter is `.venv\Scripts\python.exe`. `npm run verify` runs +the Markdown and spelling checks, the release tests, a strict MkDocs build, HTML +and link validation, the privacy scan and the accessibility checks. Serve the +site with `.venv/bin/mkdocs serve`. + +## Rules + +- Document released behaviour. The free edition is documented completely. +- Describe Pro at feature level only. Never write content that would let someone + recreate a Pro capability: no Pro commands, flags, configuration keys, + templates or step-by-step procedures. +- The catalogue on the comparison page comes from `editions.json` of the free + repository. Update it there first, then here. +- Examples contain no real credentials or private data. + +## Versions + +`package.json` declares the documented free version in `rupFlow.version`. The +documentation line is its `MAJOR.MINOR`, and the `docs/releases/index.md` front +matter must agree. The publish workflow runs on pushes to `v0.x`, creates the +immutable tag, deploys with Mike to `gh-pages` and verifies the published pages. + +## Security + +Report vulnerabilities as described in [SECURITY.md](SECURITY.md). Contributing: +[CONTRIBUTING.md](CONTRIBUTING.md). + +## License + +[MIT](LICENSE) for the documentation sources and tooling. rup-flow Pro, which +this site describes, is a separate product under its own license. diff --git a/SECURITY.md b/SECURITY.md new file mode 100644 index 0000000..dd93664 --- /dev/null +++ b/SECURITY.md @@ -0,0 +1,18 @@ +# Security policy + +This repository holds documentation sources and tooling. It processes no user +data and publishes no secrets. + +## Reporting a vulnerability + +Use GitHub private vulnerability reporting: **Security → Report a vulnerability** +on this repository, or on +[hector-ae21/rup-flow](https://github.com/hector-ae21/rup-flow/security/advisories/new) +for the skill itself. Do not open a public issue for a vulnerability or an +exposed credential. + +## Scope + +- Content that suggests an unsafe practice. +- A credential or private data committed by mistake. +- A vulnerability in the build or publication workflows. diff --git a/THIRD_PARTY_NOTICES.md b/THIRD_PARTY_NOTICES.md new file mode 100644 index 0000000..55706b7 --- /dev/null +++ b/THIRD_PARTY_NOTICES.md @@ -0,0 +1,11 @@ +# Third-party notices + +The documentation build uses PlantUML to render local diagram sources into SVG. +PlantUML is a build-time tool and is not loaded by readers' browsers: + +- Project: +- License: + +Material for MkDocs, Mike, and the development tools listed in the dependency +lock files retain their respective licences. They are build-time dependencies +and are not represented as rup-flow project code. diff --git a/cspell.json b/cspell.json new file mode 100644 index 0000000..4466c17 --- /dev/null +++ b/cspell.json @@ -0,0 +1,69 @@ +{ + "version": "0.2", + "language": "en,en-GB", + "useGitignore": true, + "files": [ + "**/*.{md,yml,yaml,json,toml,mjs,css,puml,iuml}" + ], + "ignorePaths": [ + ".cache/**", + ".venv/**", + "docs/assets/vendor/**", + "docs/reference/github-api-surface.json", + "node_modules/**", + "package-lock.json", + "requirements.lock", + "site/**" + ], + "words": [ + "scrollwrap", + "ALLGREEN", + "Arrechea", + "AKIA", + "HEADGREEN", + "oncall", + "untriaged", + "codeql", + "fontawesome", + "frontmatter", + "gitleaks", + "inlinehilite", + "iuml", + "javascripts", + "mkdocs", + "networkidle", + "objectname", + "rup-flow", + "PlantUML", + "pousr", + "pymdownx", + "dispositioned", + "lockfiles", + "squidfunk", + "skinparam", + "linetype", + "startuml", + "enduml", + "endswitch", + "endwhile", + "footbox", + "tasklist", + "tsvg", + "twemoji", + "usecase", + "venv", + "WCAG", + "rupflow", + "Agensi", + "nestjs", + "Prisma", + "statechart", + "statecharts", + "wireframes", + "wireframe", + "lms", + "Lifecycles", + "nodesep", + "ranksep" + ] +} diff --git a/docs/architecture/delivery.md b/docs/architecture/delivery.md new file mode 100644 index 0000000..730f8f7 --- /dev/null +++ b/docs/architecture/delivery.md @@ -0,0 +1,39 @@ +--- +title: Delivery and branches +description: How rup-flow is released, which branches exist and how this documentation is published. +--- + +# Delivery and branches + +## Repository + +| Branch | What it is | Who writes it | +| --- | --- | --- | +| `main` | Source of truth; protected, changes arrive through pull requests with `CI complete` | Pull requests | +| `claude-plugin` | The plugin payload the marketplace and the directory read | The release workflow, on each `vX.Y.Z` tag | +| `docs-assets` | The README screenshot and the PNG icon | The maintainer, when images change | + +The plugin tree contains no binary files; images that need one live on +`docs-assets` and are linked by address. + +## Release + +1. Move the `Unreleased` entries of the changelog to a new version section. +2. Bump the version in `package.json`, the plugin manifest and `SKILL.md`. +3. Merge to `main`, then tag `vX.Y.Z`. +4. The release workflow validates and tests, publishes `rup-flow-skill.zip` on the + GitHub release and regenerates the `claude-plugin` branch. + +## Continuous integration + +| Job | Checks | +| --- | --- | +| Validate | Skill format, manifests, links, no binaries, no Pro templates | +| Test | The CLI test suite on Linux and Windows with Node.js 18 and 22 | +| Render | `init`, `new use-case`, `render` and `check` against a real PlantUML server | + +## This documentation + +The site is built with MkDocs Material and published with Mike. The version +selector uses the free edition's `MAJOR.MINOR`. Each approved publication gets an +immutable tag and a GitHub release. See [Versioning and URLs](../releases/versioning.md). diff --git a/docs/architecture/editions.md b/docs/architecture/editions.md new file mode 100644 index 0000000..dbd26c7 --- /dev/null +++ b/docs/architecture/editions.md @@ -0,0 +1,60 @@ +--- +title: Editions and the extension point +description: How one command line serves both the free and the Pro edition. +--- + +# Editions and the extension point + +There is one CLI. Which edition you run depends on one file. + +
+ +![UML diagram showing the free skill and the private overlay combined into the rup-flow-pro package](../assets/diagrams/editions-overlay.svg) + +
+ +[Open the PlantUML source](../assets/diagrams/sources/editions-overlay.puml) + +## Detection + +At start, the CLI looks for `scripts/pro/index.mjs` next to itself: + +| File present | Edition | Behaviour | +| --- | --- | --- | +| No | Free | Runs on its own. Anything outside the edition stops with a message that names Pro. | +| Yes | Pro | The extension adds capabilities and the CLI uses them. | + +The extension is not part of this repository. It is added when the Pro package +is built. + +## What the extension adds + +The extension is a module that the CLI calls at defined points: + +| Point | Free behaviour | With the extension | +| --- | --- | --- | +| Templates | Only the free templates exist; `init` and `new use-case` skip the rest and count them | The remaining templates are present and are written | +| Rendering | Default PlantUML look | Palettes, Mermaid, PNG previews | +| Use-case index | Table | Table and the use-case diagrams | +| Commands | Free commands | Plus `themes`, `explore`, `scan` | +| Configuration | Mermaid and non-`svg` outputs are rejected | Accepted | + +## The catalogue + +`editions.json` lists every diagram, document, workflow and tool with its tier. +`RUP editions` prints it and marks what is available in the installation. The +documentation pages for the catalogue are generated from the same list, so the +CLI and this site cannot disagree. + +## Rules for contributors + +- A capability that is not in the free edition must stop with a message that + names Pro and exit with code `1`, or appear in the `available in Pro` line. It + never fails silently and is never reimplemented in the free tree. +- Every new artifact gets an entry in `editions.json`. +- Validation rejects Pro templates inside the free skill. + +## Why an overlay + +The Pro package is the free skill with the extension laid over it, renamed +`rup-flow-pro`. Nothing is forked, so a fix in the free edition reaches both. diff --git a/docs/architecture/index.md b/docs/architecture/index.md new file mode 100644 index 0000000..1e31dec --- /dev/null +++ b/docs/architecture/index.md @@ -0,0 +1,78 @@ +--- +title: Architecture +description: How the free rup-flow skill is built, what is inside the package and how the Pro extension attaches to it. +--- + +# Architecture + +rup-flow is a skill plus a small command line. It has no runtime dependencies +and no service of its own. + +## System context + +
+ +![UML diagram showing the person, the agent, the rup-flow skill, the project files and the PlantUML server](../assets/diagrams/system-context.svg) + +
+ +[Open the PlantUML source](../assets/diagrams/sources/system-context.puml) + +## Parts + +| Part | Responsibility | +| --- | --- | +| `SKILL.md` | The operating rules and the map from a request to the reference to read | +| `references/` | Methodology, loaded on demand | +| `templates/` | Starting content of each artifact, with `{{placeholders}}` | +| `scripts/rup.mjs` | The CLI: structure, index, render, check, instructions | +| `scripts/lib/` | Small modules: PlantUML client, use-case index, instruction blocks, edition loader | +| `editions.json` | The catalogue of artifacts and capabilities, free or Pro | +| `runtime/compose.yaml` | The PlantUML container definition | +| `.claude-plugin/`, `install.mjs` | Adapters for Claude Code and for clients that read `.agents/skills` | + +## Principles + +- **One portable core.** The skill follows the Agent Skills format; client + specifics live in adapters, never in the skill. +- **The agent analyses, the CLI does the boilerplate.** Structure, index, + rendering and checks are deterministic code. +- **Honesty over completeness.** The rules forbid inventing content, and the CLI + refuses what the edition does not include instead of faking it. +- **No dependencies.** Node.js 18 or newer is enough. + +## In this section + +
+ +
+ +### Editions and the extension point + +How one CLI is both the free and the Pro edition. + +[Read more](editions.md) + +
+ +
+ +### Trust and data flow + +What is read, what is written, what leaves your machine. + +[Read more](trust-and-data.md) + +
+ +
+ +### Delivery and branches + +Releases, the plugin branch and the documentation site. + +[Read more](delivery.md) + +
+ +
diff --git a/docs/architecture/trust-and-data.md b/docs/architecture/trust-and-data.md new file mode 100644 index 0000000..583ce2c --- /dev/null +++ b/docs/architecture/trust-and-data.md @@ -0,0 +1,42 @@ +--- +title: Trust and data flow +description: What rup-flow reads and writes, what it sends over the network and what it never does. +--- + +# Trust and data flow + +rup-flow has no account, no analytics and no remote service of its own. + +## On your machine + +| It does | Where | +| --- | --- | +| Reads and writes files | Inside the folders you point it at: the documentation directory and `rup.config.json` | +| Sends diagram sources | To the PlantUML server you run locally, `http://127.0.0.1:8085` by default | +| Pulls a container image | The PlantUML image from its public registry, the first time you start the server | + +Nothing else is sent anywhere. + +## The agent + +The AI agent you use with the skill (Claude, Codex, Gemini or another) processes +your prompts and files under that provider's terms and privacy policy, not +rup-flow's. + +## The PlantUML container + +The bundled compose file publishes the container on `127.0.0.1` only and runs it +with `PLANTUML_SECURITY_PROFILE=SANDBOX`, which blocks file and address access +from diagrams. Do not expose that port to a network without adding +authentication. + +## Generated documentation + +It contains whatever you or the code contain. Review it before publishing it, +especially output derived from code (paths, configuration, table names). + +## Reporting a vulnerability + +Use GitHub private vulnerability reporting on the +[rup-flow repository](https://github.com/hector-ae21/rup-flow/security): do not +open a public issue. diff --git a/docs/assets/brand/rup-flow-favicon.png b/docs/assets/brand/rup-flow-favicon.png new file mode 100644 index 0000000000000000000000000000000000000000..1d9566e7b4a0654229eba9abbe6d502a741e6eb5 GIT binary patch literal 5575 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«boundary»CheckoutScreen«control»CreateOrderController«entity»Order«entity»OrderLine«entity»Product«entity»Customer \ No newline at end of file diff --git a/docs/assets/diagrams/catalogue/collaboration.svg b/docs/assets/diagrams/catalogue/collaboration.svg new file mode 100644 index 0000000..4d5d05d --- /dev/null +++ b/docs/assets/diagrams/catalogue/collaboration.svg @@ -0,0 +1,191 @@ +«actor»Customer«boundary»CheckoutScreen«control»CreateOrderController«entity»Order«entity»Product1: confirms checkout2: createOrder(lines, address)3: checks and reserves stock4: creates with lines \ No newline at end of file diff --git a/docs/assets/diagrams/catalogue/components.svg b/docs/assets/diagrams/catalogue/components.svg new file mode 100644 index 0000000..2490024 --- /dev/null +++ b/docs/assets/diagrams/catalogue/components.svg @@ -0,0 +1,87 @@ +PresentationApplicationInfrastructureStorefrontWarehouse consoleOrders APIOrder serviceStock servicePersistence adapterPostgreSQLOrderPortHTTPSHTTPSvalidates stockrequiresrequiresprovidesSQL \ No newline at end of file diff --git a/docs/assets/diagrams/catalogue/data-model.svg b/docs/assets/diagrams/catalogue/data-model.svg new file mode 100644 index 0000000..6196846 --- /dev/null +++ b/docs/assets/diagrams/catalogue/data-model.svg @@ -0,0 +1 @@ +orderid : uuid «PK»number : varchar(20)customer_id : uuid «FK»status : varchar(12)placed_at : timestamptztotal : numeric(12,2)order_lineid : uuid «PK»order_id : uuid «FK»product_id : uuid «FK»quantity : intunit_price : numeric(12,2)productid : uuid «PK»sku : varchar(40)name : varchar(120)price : numeric(12,2)stock : int \ No newline at end of file diff --git a/docs/assets/diagrams/catalogue/deployment.svg b/docs/assets/diagrams/catalogue/deployment.svg new file mode 100644 index 0000000..eac161f --- /dev/null +++ b/docs/assets/diagrams/catalogue/deployment.svg @@ -0,0 +1,13 @@ +ApplicationapiDatabase \ No newline at end of file diff --git a/docs/assets/diagrams/catalogue/design-classes.svg b/docs/assets/diagrams/catalogue/design-classes.svg new file mode 100644 index 0000000..e3ec8f3 --- /dev/null +++ b/docs/assets/diagrams/catalogue/design-classes.svg @@ -0,0 +1,331 @@ +apiapplicationdomainpersistenceOrdersControllercreate(request) : OrderResponseCreateOrderServiceexecute(command) : OrderOrderOrderLineProductOrderRepositoryProductRepository \ No newline at end of file diff --git a/docs/assets/diagrams/catalogue/domain-model-simple.svg b/docs/assets/diagrams/catalogue/domain-model-simple.svg new file mode 100644 index 0000000..dcd4968 --- /dev/null +++ b/docs/assets/diagrams/catalogue/domain-model-simple.svg @@ -0,0 +1 @@ +OrderCustomerOrderLineProductAddress \ No newline at end of file diff --git a/docs/assets/diagrams/catalogue/domain-model.svg b/docs/assets/diagrams/catalogue/domain-model.svg new file mode 100644 index 0000000..3ecbd48 --- /dev/null +++ b/docs/assets/diagrams/catalogue/domain-model.svg @@ -0,0 +1,97 @@ +Level 1 - CoreLevel 2 - StructuralLevel 3 - DetailLevel 4 - SupportOrdernumberplacedAtstatustotalCustomeremailnameOrderLinequantityunitPriceProductskunamepricestockAddressstreetcitypostalCodecountryis made of11..*placed by0..*1sells0..*1ships to0..*1 \ No newline at end of file diff --git a/docs/assets/diagrams/catalogue/entity-states.svg b/docs/assets/diagrams/catalogue/entity-states.svg new file mode 100644 index 0000000..39e6247 --- /dev/null +++ b/docs/assets/diagrams/catalogue/entity-states.svg @@ -0,0 +1 @@ +DraftActiveArchivedactivatearchive \ No newline at end of file diff --git a/docs/assets/diagrams/catalogue/sequence.svg b/docs/assets/diagrams/catalogue/sequence.svg new file mode 100644 index 0000000..479b46f --- /dev/null +++ b/docs/assets/diagrams/catalogue/sequence.svg @@ -0,0 +1,69 @@ +CustomerOrdersControllerCreateOrderServiceProductRepositoryOrderRepositoryCustomerOrdersControllerCreateOrderServiceProductRepositoryOrderRepositoryCustomerOrdersControllerCreateOrderServiceProductRepositoryOrderRepositoryPOST /ordersexecute(command)transaction startslockBySku(skus)productsalt[stock insufficient (RN-002)]InsufficientStock409[stock available]decrease(stock)save(order)ordertransaction commitsorder201 order number \ No newline at end of file diff --git a/docs/assets/diagrams/catalogue/specification.svg b/docs/assets/diagrams/catalogue/specification.svg new file mode 100644 index 0000000..12e015d --- /dev/null +++ b/docs/assets/diagrams/catalogue/specification.svg @@ -0,0 +1 @@ +createOrder    Customer asks to check outCustomer confirms addressSystem reports unavailable stock or missing addressSystem creates order and reserves stockActor: asks to check outSystem: shows lines, totals and the address form \ No newline at end of file diff --git a/docs/assets/diagrams/catalogue/use-case-overview.svg b/docs/assets/diagrams/catalogue/use-case-overview.svg new file mode 100644 index 0000000..b5a8e8f --- /dev/null +++ b/docs/assets/diagrams/catalogue/use-case-overview.svg @@ -0,0 +1,45 @@ +Online shopOrderingFulfilmentCreate orderValidate stockCancel orderShip orderCustomerWarehouse«include» \ No newline at end of file diff --git a/docs/assets/diagrams/catalogue/use-cases-customer.svg b/docs/assets/diagrams/catalogue/use-cases-customer.svg new file mode 100644 index 0000000..4602fd1 --- /dev/null +++ b/docs/assets/diagrams/catalogue/use-cases-customer.svg @@ -0,0 +1,23 @@ +Online shopOrderingCreate orderValidate stockCancel orderCustomer«include» \ No newline at end of file diff --git a/docs/assets/diagrams/catalogue/wireframes.svg b/docs/assets/diagrams/catalogue/wireframes.svg new file mode 100644 index 0000000..79abef6 --- /dev/null +++ b/docs/assets/diagrams/catalogue/wireframes.svg @@ -0,0 +1 @@ +ShopBasketOrdersCheckoutProductQtyPriceBlue mug218.00Notebook16.50Total24.50Street City Postal code CountrySpainPlace orderBack to basket \ No newline at end of file diff --git a/docs/assets/diagrams/editions-overlay.svg b/docs/assets/diagrams/editions-overlay.svg new file mode 100644 index 0000000..0788818 --- /dev/null +++ b/docs/assets/diagrams/editions-overlay.svg @@ -0,0 +1 @@ +rup-flow (free, public, MIT)Pro overlay (private)SKILL.md, references, templatesFree workflowCLILoads an extension when presenteditions.jsonCataloguescripts/proThemes, Mermaid, explorer, scanTemplates and referencesThe full workflowPacks, domain librariesand subagentsrup-flow-pro packageOne skill, both setsWithout the extension the same CLIruns as the free edition.copiedcopiedscripts/pro/index.mjs found:Pro behaviourcopiedlaid overlaid overadded \ No newline at end of file diff --git a/docs/assets/diagrams/sources/_theme.iuml b/docs/assets/diagrams/sources/_theme.iuml new file mode 100644 index 0000000..d6e2faa --- /dev/null +++ b/docs/assets/diagrams/sources/_theme.iuml @@ -0,0 +1,93 @@ +skinparam backgroundColor transparent +skinparam shadowing false +skinparam roundCorner 12 +skinparam defaultFontName Arial +skinparam defaultFontColor #DDEBFF +skinparam ArrowColor #8EC5FF +skinparam ArrowFontColor #DDEBFF +skinparam ArrowThickness 2 +skinparam packageStyle rectangle +skinparam componentStyle rectangle +skinparam actor { + BackgroundColor #1E3A5F + BorderColor #4F8FD6 + FontColor #F8FAFC +} +skinparam usecase { + BackgroundColor #1E3A5F + BorderColor #C9DDF2 + FontColor #F8FAFC +} +skinparam component { + BackgroundColor #1E3A5F + BorderColor #4F8FD6 + FontColor #F8FAFC +} +skinparam rectangle { + BackgroundColor #1E3A5F + BorderColor #4F8FD6 + FontColor #F8FAFC +} +skinparam package { + BackgroundColor #122740 + BorderColor #C9DDF2 + FontColor #F8FAFC +} +skinparam cloud { + BackgroundColor #2F5B94 + BorderColor #8EC5FF + FontColor #F8FAFC +} +skinparam database { + BackgroundColor #2F5B94 + BorderColor #8EC5FF + FontColor #F8FAFC +} +skinparam file { + BackgroundColor #1E3A5F + BorderColor #C9DDF2 + FontColor #F8FAFC +} +skinparam class { + BackgroundColor #1E3A5F + BorderColor #4F8FD6 + HeaderBackgroundColor #2F5B94 + FontColor #F8FAFC + AttributeFontColor #DDEBFF +} +skinparam sequence { + ActorBackgroundColor #1E3A5F + ActorBorderColor #4F8FD6 + ActorFontColor #F8FAFC + LifeLineBorderColor #8EC5FF + LifeLineBackgroundColor #1E3A5F + ParticipantBackgroundColor #1E3A5F + ParticipantBorderColor #4F8FD6 + ParticipantFontColor #F8FAFC + GroupBackgroundColor #122740 + GroupBorderColor #C9DDF2 + GroupFontColor #F8FAFC +} +skinparam activity { + BackgroundColor #1E3A5F + BorderColor #4F8FD6 + FontColor #F8FAFC + DiamondBackgroundColor #2F5B94 + DiamondBorderColor #C9DDF2 + DiamondFontColor #F8FAFC + StartColor #8EC5FF + EndColor #C9DDF2 + BarColor #8EC5FF +} +skinparam note { + BackgroundColor #17304F + BorderColor #C9DDF2 + FontColor #F8FAFC +} +skinparam state { + BackgroundColor #1E3A5F + BorderColor #4F8FD6 + FontColor #F8FAFC + StartColor #8EC5FF + EndColor #C9DDF2 +} diff --git a/docs/assets/diagrams/sources/editions-overlay.puml b/docs/assets/diagrams/sources/editions-overlay.puml new file mode 100644 index 0000000..91100ae --- /dev/null +++ b/docs/assets/diagrams/sources/editions-overlay.puml @@ -0,0 +1,31 @@ +@startuml editions-overlay +!include _theme.iuml +left to right direction + +package "rup-flow (free, public, MIT)" as Free { + rectangle "SKILL.md, references, templates\nFree workflow" as FreeSkill + rectangle "CLI\nLoads an extension when present" as FreeCli + rectangle "editions.json\nCatalogue" as Catalogue +} + +package "Pro overlay (private)" as Pro { + rectangle "scripts/pro\nThemes, Mermaid, explorer, scan" as Extension + rectangle "Templates and references\nThe full workflow" as ProTemplates + rectangle "Packs, domain libraries\nand subagents" as Extras +} + +rectangle "rup-flow-pro package\nOne skill, both sets" as Package + +FreeSkill --> Package : copied +FreeCli --> Package : copied +Catalogue --> Package : copied +Extension --> Package : laid over +ProTemplates --> Package : laid over +Extras --> Package : added +Package ..> FreeCli : scripts/pro/index.mjs found:\nPro behaviour + +note bottom of Free + Without the extension the same CLI + runs as the free edition. +end note +@enduml diff --git a/docs/assets/diagrams/sources/system-context.puml b/docs/assets/diagrams/sources/system-context.puml new file mode 100644 index 0000000..ab98a84 --- /dev/null +++ b/docs/assets/diagrams/sources/system-context.puml @@ -0,0 +1,26 @@ +@startuml system-context +!include _theme.iuml +left to right direction + +actor "Developer or analyst" as Person +rectangle "AI coding agent\nClaude Code, Claude on the web, Codex, Gemini CLI" as Agent + +rectangle "rup-flow skill" as Skill { + rectangle "SKILL.md and references\nRules and methodology, loaded on demand" as Rules + rectangle "CLI (rup.mjs)\ninit, new use-case, index, render, check" as CLI + rectangle "Templates and editions catalogue" as Templates +} + +database "The documentation folder and\nthe configuration file" as Files +rectangle "PlantUML server\nLocal Docker container, 127.0.0.1" as PlantUML + +Person --> Agent : prompt +Agent --> Rules : reads +Agent --> CLI : runs +CLI --> Templates : fills +CLI --> Files : reads and writes +CLI --> PlantUML : diagram sources +PlantUML --> CLI : SVG +Agent --> Files : writes documents +Agent --> Person : report: created, open questions, unchecked +@enduml diff --git a/docs/assets/diagrams/system-context.svg b/docs/assets/diagrams/system-context.svg new file mode 100644 index 0000000..a8b447c --- /dev/null +++ b/docs/assets/diagrams/system-context.svg @@ -0,0 +1 @@ +rup-flow skillSKILL.md and referencesRules and methodology, loaded on demandCLI (rup.mjs)init, new use-case, index, render, checkTemplates and editions catalogueDeveloper or analystAI coding agentClaude Code, Claude on the web, Codex, Gemini CLIThe documentation folder andthe configuration filePlantUML serverLocal Docker container, 127.0.0.1promptreport: created, open questions, uncheckedreadsrunsfillsreads and writesdiagram sourcesSVGwrites documents \ No newline at end of file diff --git a/docs/assets/explorer/explorer-overview.png b/docs/assets/explorer/explorer-overview.png new file mode 100644 index 0000000000000000000000000000000000000000..bde6e9f0a27a393772014f08d44aee777efa1920 GIT binary patch literal 103300 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 xh8x($ { + for (const sidebar of document.querySelectorAll('.md-sidebar')) { + const primaryNavigation = sidebar.querySelector('.md-nav--primary.md-nav--lifted'); + const activeTopLevelItem = primaryNavigation?.querySelector( + ':scope > .md-nav__list > .md-nav__item--active', + ); + const links = [...sidebar.querySelectorAll('a.md-nav__link[href]')] + .filter((link) => !link.closest('[hidden]')) + .map((link) => link.href); + const sparse = activeTopLevelItem + ? !activeTopLevelItem.classList.contains('md-nav__item--nested') + : new Set(links).size <= 1; + sidebar.classList.toggle('rup-sidebar--sparse', sparse); + } +}; + +if (typeof document$ !== 'undefined') { + document$.subscribe(updateRupNavigation); +} else { + document.addEventListener('DOMContentLoaded', updateRupNavigation); +} diff --git a/docs/assets/mermaid/collaboration.svg b/docs/assets/mermaid/collaboration.svg new file mode 100644 index 0000000..47fe729 --- /dev/null +++ b/docs/assets/mermaid/collaboration.svg @@ -0,0 +1,1049 @@ +

1: confirms checkout

2: createOrder(lines, address)

3: checks and reserves stock

4: creates with lines

Customer

CheckoutScreen
boundary

CreateOrderController
control

Product
entity

Order
entity

\ No newline at end of file diff --git a/docs/assets/mermaid/components.svg b/docs/assets/mermaid/components.svg new file mode 100644 index 0000000..98e7864 --- /dev/null +++ b/docs/assets/mermaid/components.svg @@ -0,0 +1,119 @@ +

Infrastructure

Application

Presentation

HTTPS

HTTPS

validates stock

requires

requires

provides

SQL

Storefront

Warehouse console

Orders API

Order service

Stock service

Persistence adapter

PostgreSQL

OrderPort

\ No newline at end of file diff --git a/docs/assets/mermaid/data-model.svg b/docs/assets/mermaid/data-model.svg new file mode 100644 index 0000000..5ac93fe --- /dev/null +++ b/docs/assets/mermaid/data-model.svg @@ -0,0 +1,951 @@ +

contains

is sold in

ORDER

uuid

id

PK

varchar

number

uuid

customer_id

FK

varchar

status

timestamptz

placed_at

numeric

total

ORDER_LINE

uuid

id

PK

uuid

order_id

FK

uuid

product_id

FK

int

quantity

numeric

unit_price

PRODUCT

uuid

id

PK

varchar

sku

varchar

name

numeric

price

int

stock

\ No newline at end of file diff --git a/docs/assets/mermaid/deployment.svg b/docs/assets/mermaid/deployment.svg new file mode 100644 index 0000000..7907240 --- /dev/null +++ b/docs/assets/mermaid/deployment.svg @@ -0,0 +1,1095 @@ +

Application node

HTTPS

order.placed

Customer browser

orders api

fulfilment worker

PostgreSQL

Message broker

\ No newline at end of file diff --git a/docs/assets/mermaid/domain-model-forest.svg b/docs/assets/mermaid/domain-model-forest.svg new file mode 100644 index 0000000..cd54b09 --- /dev/null +++ b/docs/assets/mermaid/domain-model-forest.svg @@ -0,0 +1,231 @@ +

is made of

1

1..*

placed by

0..*

1

sells

0..*

1

ships to

0..*

1

Order

number

placedAt

status

total

Customer

email

name

OrderLine

quantity

unitPrice

Product

sku

name

price

stock

Address

street

city

postalCode

country

\ No newline at end of file diff --git a/docs/assets/mermaid/domain-model.svg b/docs/assets/mermaid/domain-model.svg new file mode 100644 index 0000000..eedd09f --- /dev/null +++ b/docs/assets/mermaid/domain-model.svg @@ -0,0 +1,231 @@ +

is made of

1

1..*

placed by

0..*

1

sells

0..*

1

ships to

0..*

1

Order

number

placedAt

status

total

Customer

email

name

OrderLine

quantity

unitPrice

Product

sku

name

price

stock

Address

street

city

postalCode

country

\ No newline at end of file diff --git a/docs/assets/mermaid/sequence-dark.svg b/docs/assets/mermaid/sequence-dark.svg new file mode 100644 index 0000000..48977c5 --- /dev/null +++ b/docs/assets/mermaid/sequence-dark.svg @@ -0,0 +1,91 @@ +OrderRepositoryProductRepositoryCreateOrderServiceOrdersControllerOrderRepositoryProductRepositoryCreateOrderServiceOrdersControllertransaction startstransaction commitsalt[stock insufficient (RN-002)][stock available]CustomerPOST /ordersexecute(command)lockBySku(skus)productsInsufficientStock409decrease(stock)save(order)orderorder201 order numberCustomer \ No newline at end of file diff --git a/docs/assets/mermaid/sequence.svg b/docs/assets/mermaid/sequence.svg new file mode 100644 index 0000000..99da1e3 --- /dev/null +++ b/docs/assets/mermaid/sequence.svg @@ -0,0 +1,91 @@ +OrderRepositoryProductRepositoryCreateOrderServiceOrdersControllerOrderRepositoryProductRepositoryCreateOrderServiceOrdersControllertransaction startstransaction commitsalt[stock insufficient (RN-002)][stock available]CustomerPOST /ordersexecute(command)lockBySku(skus)productsInsufficientStock409decrease(stock)save(order)orderorder201 order numberCustomer \ No newline at end of file diff --git a/docs/assets/mermaid/specification.svg b/docs/assets/mermaid/specification.svg new file mode 100644 index 0000000..f838fea --- /dev/null +++ b/docs/assets/mermaid/specification.svg @@ -0,0 +1,387 @@ +

createOrder

Customer asks to check out

Customer confirms address

System reports unavailable stock or missing address

System creates order and reserves stock

Basket

Checkout

Validating

Placed

Actor: asks to check out
System: shows lines, totals and the address form

\ No newline at end of file diff --git a/docs/assets/mermaid/use-case-overview.svg b/docs/assets/mermaid/use-case-overview.svg new file mode 100644 index 0000000..57a6678 --- /dev/null +++ b/docs/assets/mermaid/use-case-overview.svg @@ -0,0 +1,2073 @@ +

Online shop

Fulfilment

Ordering

include

Customer

Warehouse

Create order

Validate stock

Cancel order

Ship order

\ No newline at end of file diff --git a/docs/assets/stylesheets/extra.css b/docs/assets/stylesheets/extra.css new file mode 100644 index 0000000..7c4d7ea --- /dev/null +++ b/docs/assets/stylesheets/extra.css @@ -0,0 +1,770 @@ +:root { + --md-primary-fg-color: #1e3a5f; + --md-primary-fg-color--light: #2f5b94; + --md-primary-fg-color--dark: #122740; + --md-accent-fg-color: #2b66b0; + --md-code-hl-comment-color: #626262; + --md-typeset-a-color: #1f5aa6; + --rup-cyan: #4f8fd6; + --rup-violet: #35609a; + --rup-ink: #122740; + --rup-panel: #f5f8fc; + --rup-border: #c9ddf2; + --rup-shadow: 0 1.2rem 3rem rgb(18 39 64 / 12%); +} + +[data-md-color-scheme="default"] { + --md-code-hl-comment-color: #626262; +} + +[data-md-color-scheme="slate"] { + --md-default-bg-color: #0b1626; + --md-default-bg-color--light: #101e33; + --md-default-bg-color--lighter: #172a46; + --md-default-bg-color--lightest: #1f3555; + --md-default-fg-color: #eef6ff; + --md-default-fg-color--light: #cedcf0; + --md-default-fg-color--lighter: #a9bdd7; + --md-default-fg-color--lightest: #849bb8; + --md-primary-fg-color: #24497a; + --md-primary-fg-color--light: #3a6aa3; + --md-primary-fg-color--dark: #17304f; + --md-accent-fg-color: #8ec5ff; + --md-code-hl-comment-color: #c1d0e4; + --md-typeset-a-color: #a9d3ff; + --rup-cyan: #8ec5ff; + --rup-violet: #c9ddf2; + --rup-ink: #eef6ff; + --rup-panel: #112239; + --rup-border: #2c4a75; + --rup-shadow: 0 1.2rem 3rem rgb(0 0 0 / 32%); +} + +.md-header { + background: linear-gradient(110deg, var(--md-primary-fg-color--dark), var(--md-primary-fg-color)); + border-bottom: 0.05rem solid rgb(142 197 255 / 35%); + box-shadow: 0 0.3rem 1.2rem rgb(2 8 23 / 22%); +} + +.md-tabs { + background: var(--md-primary-fg-color--dark); + border-bottom: 0.05rem solid rgb(142 197 255 / 18%); +} + +.md-tabs__list { + align-items: center; + gap: 0; +} + +.md-tabs__item { + height: auto; + padding-inline: 0; +} + +.md-tabs__link { + border: 0.05rem solid transparent; + border-radius: 0; + margin-top: 0; + opacity: 1; + padding: 0.42rem 0.78rem; + transition: background-color 150ms ease, border-color 150ms ease, color 150ms ease; +} + +.md-tabs__item:first-child .md-tabs__link { + border-radius: 0.42rem 0 0 0.42rem; +} + +.md-tabs__item:last-child .md-tabs__link { + border-radius: 0 0.42rem 0.42rem 0; +} + +.md-tabs__item--active .md-tabs__link, +.md-tabs__link:hover, +.md-tabs__link:focus-visible { + color: #fff; +} + +.md-tabs__item--active .md-tabs__link { + background: rgb(142 197 255 / 12%); + border-color: rgb(142 197 255 / 30%); + box-shadow: 0 0.28rem 0.8rem rgb(2 8 23 / 18%); + color: #d4e8ff; +} + +.md-grid { + max-width: 92rem; +} + +.md-main__inner { + margin-top: 1.25rem; +} + +.md-main__inner:has(.rup-hero) { + margin-top: 0.7rem; +} + +.md-sidebar__scrollwrap { + scrollbar-color: var(--rup-border) transparent; +} + +.md-sidebar--primary .md-sidebar__inner, +.md-sidebar--secondary .md-sidebar__inner { + background: color-mix(in srgb, var(--rup-panel) 72%, transparent); + border: 0.05rem solid var(--rup-border); + border-radius: 0.7rem; + padding: 0.7rem; +} + +.md-sidebar--primary .md-sidebar__inner { + padding: 0 0 0 0.7rem; +} + +/* Material pins the section heading while the rest of the navigation scrolls. + It needs an opaque background of its own, otherwise the links pass visibly + underneath it. The mix reproduces the translucent panel over the page, so + the heading is opaque without reading as a different surface. */ +.md-sidebar--primary .md-nav__title, +.md-sidebar--secondary .md-nav__title { + background: color-mix(in srgb, var(--rup-panel) 72%, var(--md-default-bg-color)); + box-shadow: none !important; + font-size: 0.68rem; + font-weight: 800; + letter-spacing: 0.08em; + text-transform: uppercase; +} + +.md-sidebar--primary .md-nav__title::after, +.md-sidebar--primary .md-nav__title::before { + box-shadow: none !important; + display: none; +} + +.md-sidebar--primary .md-nav--lifted > .md-nav__list > .md-nav__item--active > + .md-nav__link.md-nav__container { + background: color-mix(in srgb, var(--rup-panel) 72%, var(--md-default-bg-color)); + box-shadow: none !important; +} + +.md-sidebar--primary .md-nav__link.md-nav__container > a.md-nav__link { + padding-left: 0.38rem; +} + +.md-sidebar--primary .md-nav__link.md-nav__container { + padding-left: 0; +} + +.md-sidebar .md-nav__link { + align-items: center; + border-radius: 0.38rem; + font-weight: 500; + margin-top: 0.18rem; + min-height: 1.6rem; + padding: 0.38rem 0.48rem; + text-decoration: none; + transition: background-color 120ms ease, color 120ms ease; +} + +.md-sidebar .md-nav__link:hover, +.md-sidebar .md-nav__link:focus-visible { + background: rgb(79 143 214 / 10%); +} + +.md-sidebar .md-nav__link--active { + background: rgb(79 143 214 / 10%); + box-shadow: inset 0.13rem 0 var(--rup-cyan) !important; + color: var(--md-typeset-a-color); + font-weight: 500; +} + +.md-sidebar--primary .md-nav[data-md-level="1"] > .md-nav__list > .md-nav__item--nested > .md-nav__link, +.md-sidebar--primary .md-nav[data-md-level="2"] > .md-nav__list > .md-nav__item--nested > .md-nav__link { + color: var(--rup-ink); + font-weight: 750; + margin-top: 0.75rem; +} + +.md-sidebar--primary .md-nav[data-md-level="2"] > .md-nav__list { + margin-left: 0.55rem; +} + +.md-sidebar--primary .md-nav[data-md-level="3"] > .md-nav__list { + margin-left: 0.85rem; +} + +.md-sidebar--primary .md-nav[data-md-level="2"] .md-nav__link { + padding-left: 0.65rem; +} + +.md-sidebar--primary .md-nav[data-md-level="3"] .md-nav__link { + padding-left: 0.9rem; +} + +.md-sidebar--secondary .md-nav__list { + border-left: 0.05rem solid var(--rup-border); + margin-left: 0.25rem; + padding-left: 0.45rem; +} + +.md-sidebar--secondary .md-nav__link--active { + box-shadow: inset 0.14rem 0 var(--rup-violet); +} + +.md-sidebar--secondary.rup-sidebar--sparse { + display: none; +} + +.md-content__inner { + padding-bottom: 4rem; +} + +.md-typeset { + font-size: 0.82rem; + line-height: 1.72; +} + +.md-typeset h1 { + color: var(--rup-ink); + font-size: clamp(2rem, 4vw, 3.15rem); + font-weight: 780; + letter-spacing: -0.04em; + line-height: 1.08; +} + +.md-typeset h2 { + border-top: 0.05rem solid var(--rup-border); + font-size: clamp(1.45rem, 2.4vw, 2rem); + font-weight: 720; + letter-spacing: -0.025em; + margin-top: 3.4rem; + padding-top: 1.25rem; +} + +.md-typeset h3 { + font-weight: 700; +} + +.md-typeset a:not(.md-button) { + text-decoration: underline; + text-decoration-thickness: 0.06em; + text-underline-offset: 0.15em; +} + +.md-typeset code { + border-radius: 0.28rem; +} + +.md-typeset .highlight { + background: transparent; + border: 0; + border-radius: 0; + box-shadow: none; + max-width: 100%; + overflow: visible; +} + +.md-typeset .highlight > .filename { + background: transparent; + border-bottom: 0.1rem solid var(--rup-cyan); + box-shadow: none; + color: var(--rup-ink); + display: block; + font-weight: 750; + margin-bottom: 0.45rem; + padding: 0 0.08rem 0.22rem; + width: fit-content; +} + +.md-typeset .highlight pre { + background: color-mix(in srgb, var(--md-code-bg-color) 94%, var(--rup-panel)); + border: 0.05rem solid color-mix(in srgb, var(--rup-border) 72%, transparent); + border-radius: 0.65rem; + box-shadow: 0 0.7rem 1.8rem rgb(18 39 64 / 14%); + margin: 0; + overflow: auto; +} + +[data-md-color-scheme="slate"] .md-typeset .highlight pre { + box-shadow: 0 0.8rem 2rem rgb(0 0 0 / 28%); +} + +.md-typeset .md-clipboard { + color: var(--rup-ink); + opacity: 0.72; +} + +.md-typeset .md-clipboard:hover, +.md-typeset .md-clipboard:focus-visible { + color: var(--md-typeset-a-color); + opacity: 1; +} + +.md-typeset .admonition, +.md-typeset details { + border-radius: 0.55rem; + box-shadow: 0 0.4rem 1.1rem rgb(18 39 64 / 8%); +} + +.md-typeset table:not([class]) { + border: 0.05rem solid var(--rup-border); + border-radius: 0.45rem; +} + +.md-typeset__table { + display: inline-block; + max-width: 100%; + overflow-x: auto; + padding: 0; + scrollbar-color: var(--rup-border) transparent; + vertical-align: top; + width: auto; +} + +.md-typeset__table table:not([class]) { + max-width: none; + width: auto; +} + +.md-typeset table:not([class]) th { + background: var(--rup-panel); +} + +.md-typeset .go, +.md-typeset .nv { + color: #686868; +} + +[data-md-color-scheme="slate"] .md-typeset .go, +[data-md-color-scheme="slate"] .md-typeset .nv { + color: #c1d0e4; +} + +.md-copyright { + color: #8b8b8b; +} + +[data-md-color-scheme="slate"] .md-copyright { + color: #b9c8dc; +} + +.rup-hero { + align-items: center; + background: + radial-gradient(circle at 88% 12%, rgb(142 197 255 / 20%), transparent 30%), + radial-gradient(circle at 14% 90%, rgb(53 96 154 / 14%), transparent 34%), + linear-gradient(135deg, var(--rup-panel), var(--md-default-bg-color)); + border: 0.05rem solid var(--rup-border); + border-radius: 1.25rem; + box-shadow: var(--rup-shadow); + display: grid; + gap: clamp(2rem, 6vw, 5rem); + grid-template-columns: minmax(0, 1.2fr) minmax(16rem, 0.8fr); + margin: 0.45rem auto 3rem; + max-width: 78rem; + overflow: hidden; + padding: clamp(2rem, 4.5vw, 4rem); + position: relative; +} + +.rup-hero-copy, +.rup-hero-visual { + position: relative; + z-index: 1; +} + +.rup-eyebrow { + color: var(--md-typeset-a-color); + font-size: 0.68rem; + font-weight: 800; + letter-spacing: 0.14em; + margin-bottom: 1rem; + text-transform: uppercase; +} + +.rup-hero h1 { + font-size: clamp(2.4rem, 4.4vw, 4.1rem); + margin: 0 0 1.15rem; + max-width: 14ch; +} + +.rup-lead { + color: var(--md-default-fg-color--light); + font-size: clamp(1.05rem, 1.8vw, 1.28rem); + line-height: 1.62; + max-width: 42rem; +} + +.rup-actions { + display: flex; + flex-wrap: wrap; + gap: 0.75rem; + margin-top: 1.75rem; +} + +.rup-actions .md-button { + border-radius: 999px; + padding-inline: 1.25rem; +} + +.rup-actions .md-button:not(.md-button--primary) { + border-color: var(--rup-cyan); + color: var(--md-typeset-a-color); +} + +.rup-hero-visual { + align-items: center; + display: flex; + justify-content: center; + min-height: 20rem; +} + +.rup-hero-logo { + filter: drop-shadow(0 1.8rem 1.4rem rgb(30 58 95 / 30%)); + margin: 0; + max-height: 30rem; + width: min(100%, 31rem); +} + +.rup-pill-row { + display: flex; + flex-wrap: wrap; + gap: 0.55rem; + margin-top: 1.5rem; +} + +.rup-pill { + background: rgb(79 143 214 / 10%); + border: 0.05rem solid rgb(79 143 214 / 38%); + border-radius: 999px; + color: var(--rup-ink); + font-size: 0.68rem; + font-weight: 700; + padding: 0.35rem 0.7rem; +} + +.rup-section-intro { + color: var(--md-default-fg-color--light); + font-size: 1rem; + max-width: 52rem; +} + +.rup-grid { + display: grid; + gap: 1rem; + grid-template-columns: repeat(3, minmax(0, 1fr)); + margin: 1.5rem 0 2.5rem; +} + +.rup-grid--journey { + grid-template-columns: repeat(2, minmax(0, 1fr)); +} + +.rup-grid > *, +.rup-split > * { + min-width: 0; +} + +.rup-card { + background: var(--rup-panel); + border: 0.05rem solid var(--rup-border); + border-radius: 0.75rem; + box-shadow: 0 0.65rem 1.8rem rgb(18 39 64 / 8%); + padding: 1.45rem; +} + +.rup-card--linked { + display: flex; + flex-direction: column; +} + +.rup-card h2, +.rup-card h3 { + border-top: 0; + margin: 0 0 0.85rem; + padding-top: 0; +} + +.rup-card h2::after, +.rup-card h3::after { + background: var(--rup-border); + content: ""; + display: block; + height: 0.05rem; + margin-top: 0.72rem; + width: 100%; +} + +.rup-card--linked > p:last-child { + margin-top: auto; + padding-top: 0.85rem; +} + +.rup-card p:last-child { + margin-bottom: 0; +} + +.rup-step { + border-top: 0.18rem solid var(--rup-cyan); +} + +.rup-step-number { + color: var(--md-typeset-a-color); + display: block; + font-size: 0.68rem; + font-weight: 800; + letter-spacing: 0.14em; + margin-bottom: 0.9rem; + text-transform: uppercase; +} + +.rup-split { + align-items: start; + display: grid; + gap: clamp(1.5rem, 4vw, 3rem); + grid-template-columns: repeat(2, minmax(0, 1fr)); + margin: 1.5rem 0 2.5rem; +} + +.rup-callout { + background: linear-gradient(135deg, rgb(79 143 214 / 12%), rgb(53 96 154 / 10%)); + border: 0.05rem solid var(--rup-border); + border-left: 0.25rem solid var(--rup-cyan); + border-radius: 0.65rem; + margin: 2rem 0; + padding: 1rem 1.25rem; +} + +.rup-example { + margin-bottom: 1.5rem; +} + +.rup-example > p:last-child { + display: flex; + justify-content: flex-end; + margin: 0.55rem 0 0; +} + +.rup-example-download { + align-items: center; + background: rgb(79 143 214 / 8%); + border: 0.05rem solid rgb(79 143 214 / 32%); + border-radius: 999px; + color: var(--md-typeset-a-color) !important; + display: inline-flex; + font-size: 0.68rem; + font-weight: 700; + gap: 0.35rem; + min-height: 1.8rem; + justify-content: center; + padding: 0.25rem 0.68rem; + text-decoration: none !important; + transition: background-color 120ms ease, border-color 120ms ease, color 120ms ease; +} + +.rup-example-download:hover, +.rup-example-download:focus-visible { + background: rgb(79 143 214 / 16%); + border-color: var(--rup-cyan); + color: var(--md-accent-fg-color) !important; +} + +.rup-example-download svg { + fill: currentcolor; + height: 0.9rem; + width: 0.9rem; +} + +.rup-diagram { + background: + radial-gradient(circle at 50% 0, rgb(142 197 255 / 7%), transparent 38%), + #0b1626; + border: 0.05rem solid #3d5f8c; + border-radius: 0.75rem; + box-shadow: var(--rup-shadow); + margin: 1.5rem 0 0.7rem; + overflow: auto; + padding: clamp(1rem, 2.5vw, 1.75rem); +} + +.rup-diagram img { + display: block; + margin: 0 auto; + min-width: 42rem; +} + +.rup-diagram + p { + display: flex; + justify-content: flex-end; + margin-top: 0; +} + +.rup-diagram + p > a { + align-items: center; + background: rgb(53 96 154 / 8%); + border: 0.05rem solid rgb(53 96 154 / 28%); + border-radius: 999px; + display: inline-flex; + font-size: 0.68rem; + font-weight: 700; + padding: 0.28rem 0.7rem; + text-decoration: none; +} + +.md-footer__inner { + display: none; +} + +@media screen and (max-width: 76.2344em) { + .md-grid { + max-width: 100%; + } +} + +@media screen and (min-width: 76.25em) { + .md-main__inner:has(.rup-hero) .md-sidebar--primary { + display: none; + } + + .md-sidebar--primary:has( + .md-nav--lifted > .md-nav__list > .md-nav__item--active:not(.md-nav__item--nested) + ), + .md-sidebar--primary.rup-sidebar--sparse { + display: none; + } +} + +@media screen and (max-width: 60em) { + .md-main__inner { + margin-top: 0.9rem; + } + + .md-content__inner { + padding-bottom: 2.75rem; + } + + .rup-hero { + gap: 1.5rem; + grid-template-columns: 1fr; + } + + .rup-hero-copy { + text-align: center; + } + + .rup-hero h1, + .rup-lead { + margin-inline: auto; + } + + .rup-actions, + .rup-pill-row { + justify-content: center; + } + + .rup-hero-visual { + min-height: auto; + } + + .rup-hero-logo { + max-width: 23rem; + } +} + +@media screen and (max-width: 44.9844em) { + .rup-grid, + .rup-grid--journey, + .rup-split { + grid-template-columns: 1fr; + } + + .rup-hero { + border-radius: 0.75rem; + padding: 1.6rem; + } + + .rup-hero h1 { + font-size: clamp(2.15rem, 10vw, 3.1rem); + } + + .rup-actions .md-button { + text-align: center; + width: 100%; + } + + .rup-diagram img { + min-width: 32rem; + } +} + +@media screen and (max-width: 22em) { + .md-typeset h1 { + font-size: 2rem; + } + + .rup-hero { + padding: 1.15rem; + } + + .rup-hero h1 { + font-size: 2.05rem; + } + + .rup-card { + padding: 1.1rem; + } + + .rup-diagram { + padding: 0.75rem; + } +} + +.rup-diagram--light { + background: #fff; + border-color: var(--rup-border); +} + +.rup-diagram--light img { + max-width: 100%; +} + +.rup-pro-tag { + background: rgb(79 143 214 / 14%); + border: 0.05rem solid rgb(79 143 214 / 38%); + border-radius: 999px; + color: var(--md-typeset-a-color); + font-size: 0.62rem; + font-weight: 800; + letter-spacing: 0.08em; + padding: 0.12rem 0.5rem; + text-transform: uppercase; +} + +.rup-gallery { + display: grid; + gap: 1.25rem; + grid-template-columns: repeat(auto-fill, minmax(17rem, 1fr)); + margin: 1.5rem 0; +} + +.rup-gallery figure { + background: #fff; + border: 0.05rem solid var(--rup-border); + border-radius: 0.75rem; + margin: 0; + overflow: auto; + padding: 0.9rem; +} + +.rup-gallery img { + display: block; + margin: 0 auto; + max-height: 22rem; + max-width: 100%; + width: auto; +} + +.rup-gallery figcaption { + color: #1f2a3a; + font-size: 0.74rem; + margin-top: 0.7rem; + text-align: center; +} diff --git a/docs/assets/themes/custom.svg b/docs/assets/themes/custom.svg new file mode 100644 index 0000000..c3389e4 --- /dev/null +++ b/docs/assets/themes/custom.svg @@ -0,0 +1,97 @@ +Level 1 - CoreLevel 2 - StructuralLevel 3 - DetailLevel 4 - SupportOrdernumberplacedAtstatustotalCustomeremailnameOrderLinequantityunitPriceProductskunamepricestockAddressstreetcitypostalCodecountryis made of11..*placed by0..*1sells0..*1ships to0..*1 \ No newline at end of file diff --git a/docs/assets/themes/dark.svg b/docs/assets/themes/dark.svg new file mode 100644 index 0000000..2518b38 --- /dev/null +++ b/docs/assets/themes/dark.svg @@ -0,0 +1,97 @@ +Level 1 - CoreLevel 2 - StructuralLevel 3 - DetailLevel 4 - SupportOrdernumberplacedAtstatustotalCustomeremailnameOrderLinequantityunitPriceProductskunamepricestockAddressstreetcitypostalCodecountryis made of11..*placed by0..*1sells0..*1ships to0..*1 \ No newline at end of file diff --git a/docs/assets/themes/default.svg b/docs/assets/themes/default.svg new file mode 100644 index 0000000..3ecbd48 --- /dev/null +++ b/docs/assets/themes/default.svg @@ -0,0 +1,97 @@ +Level 1 - CoreLevel 2 - StructuralLevel 3 - DetailLevel 4 - SupportOrdernumberplacedAtstatustotalCustomeremailnameOrderLinequantityunitPriceProductskunamepricestockAddressstreetcitypostalCodecountryis made of11..*placed by0..*1sells0..*1ships to0..*1 \ No newline at end of file diff --git a/docs/assets/themes/forest.svg b/docs/assets/themes/forest.svg new file mode 100644 index 0000000..18ddeb0 --- /dev/null +++ b/docs/assets/themes/forest.svg @@ -0,0 +1,97 @@ +Level 1 - CoreLevel 2 - StructuralLevel 3 - DetailLevel 4 - SupportOrdernumberplacedAtstatustotalCustomeremailnameOrderLinequantityunitPriceProductskunamepricestockAddressstreetcitypostalCodecountryis made of11..*placed by0..*1sells0..*1ships to0..*1 \ No newline at end of file diff --git a/docs/assets/themes/grape.svg b/docs/assets/themes/grape.svg new file mode 100644 index 0000000..a54b230 --- /dev/null +++ b/docs/assets/themes/grape.svg @@ -0,0 +1,97 @@ +Level 1 - CoreLevel 2 - StructuralLevel 3 - DetailLevel 4 - SupportOrdernumberplacedAtstatustotalCustomeremailnameOrderLinequantityunitPriceProductskunamepricestockAddressstreetcitypostalCodecountryis made of11..*placed by0..*1sells0..*1ships to0..*1 \ No newline at end of file diff --git a/docs/assets/themes/high-contrast.svg b/docs/assets/themes/high-contrast.svg new file mode 100644 index 0000000..d5ce81a --- /dev/null +++ b/docs/assets/themes/high-contrast.svg @@ -0,0 +1,97 @@ +Level 1 - CoreLevel 2 - StructuralLevel 3 - DetailLevel 4 - SupportOrdernumberplacedAtstatustotalCustomeremailnameOrderLinequantityunitPriceProductskunamepricestockAddressstreetcitypostalCodecountryis made of11..*placed by0..*1sells0..*1ships to0..*1 \ No newline at end of file diff --git a/docs/assets/themes/mono.svg b/docs/assets/themes/mono.svg new file mode 100644 index 0000000..37c282b --- /dev/null +++ b/docs/assets/themes/mono.svg @@ -0,0 +1,97 @@ +Level 1 - CoreLevel 2 - StructuralLevel 3 - DetailLevel 4 - SupportOrdernumberplacedAtstatustotalCustomeremailnameOrderLinequantityunitPriceProductskunamepricestockAddressstreetcitypostalCodecountryis made of11..*placed by0..*1sells0..*1ships to0..*1 \ No newline at end of file diff --git a/docs/assets/themes/ocean.svg b/docs/assets/themes/ocean.svg new file mode 100644 index 0000000..d85996e --- /dev/null +++ b/docs/assets/themes/ocean.svg @@ -0,0 +1,97 @@ +Level 1 - CoreLevel 2 - StructuralLevel 3 - DetailLevel 4 - SupportOrdernumberplacedAtstatustotalCustomeremailnameOrderLinequantityunitPriceProductskunamepricestockAddressstreetcitypostalCodecountryis made of11..*placed by0..*1sells0..*1ships to0..*1 \ No newline at end of file diff --git a/docs/assets/themes/overview.svg b/docs/assets/themes/overview.svg new file mode 100644 index 0000000..aa131a6 --- /dev/null +++ b/docs/assets/themes/overview.svg @@ -0,0 +1,107 @@ + + + + + default + Neutral blue-gray on white. Safe for any document. + + + + + + + + primary · secondary · accent · levels 1-4 + + + + ocean + Blues and teals. + + + + + + + + primary · secondary · accent · levels 1-4 + + + + forest + Greens, calm and low contrast. + + + + + + + + primary · secondary · accent · levels 1-4 + + + + sunset + Warm oranges and reds. + + + + + + + + primary · secondary · accent · levels 1-4 + + + + grape + Purples. + + + + + + + + primary · secondary · accent · levels 1-4 + + + + mono + Grayscale. Prints well in black and white. + + + + + + + + primary · secondary · accent · levels 1-4 + + + + dark + Dark background, light lines. + + + + + + + + primary · secondary · accent · levels 1-4 + + + + high-contrast + Black on white and yellow, for accessibility. + + + + + + + + primary · secondary · accent · levels 1-4 + + diff --git a/docs/assets/themes/sunset.svg b/docs/assets/themes/sunset.svg new file mode 100644 index 0000000..62e620e --- /dev/null +++ b/docs/assets/themes/sunset.svg @@ -0,0 +1,97 @@ +Level 1 - CoreLevel 2 - StructuralLevel 3 - DetailLevel 4 - SupportOrdernumberplacedAtstatustotalCustomeremailnameOrderLinequantityunitPriceProductskunamepricestockAddressstreetcitypostalCodecountryis made of11..*placed by0..*1sells0..*1ships to0..*1 \ No newline at end of file diff --git a/docs/configuration/index.md b/docs/configuration/index.md new file mode 100644 index 0000000..13879d5 --- /dev/null +++ b/docs/configuration/index.md @@ -0,0 +1,69 @@ +--- +title: Configuration +description: The rup.config.json keys of the free edition and how flags override them. +--- + +# Configuration + +`rup.config.json` sits in the project root. `init` creates it; every key is +optional because the defaults below apply. + +```json title="rup.config.json" +{ + "project": "my-project", + "outDir": "docs/rup", + "docLanguage": "en", + "codeRoot": "src", + "paths": { + "domain": "00-domain-model", + "requirements": "01-requirements", + "analysis": "02-analysis", + "design": "03-design", + "implementation": "04-implementation", + "quality": "05-quality" + }, + "useCaseDir": "use-cases", + "plantuml": { "url": "http://127.0.0.1:8085", "timeoutMs": 30000 }, + "diagrams": { "language": "plantuml", "outputs": ["svg"] }, + "ids": { "requirement": "RF", "nonFunctional": "RNF", "useCase": "UC", "rule": "RN", "decision": "DEC", "test": "TC" }, + "targetStack": { "language": "", "framework": "", "persistence": "", "testing": "" } +} +``` + +## Keys + +| Key | Default | Meaning | +| --- | --- | --- | +| `project` | folder name | Name used in titles | +| `outDir` | `docs/rup` | Root of the documentation, relative to the project root | +| `docLanguage` | `en` | Language of the documents. File names, IDs, front-matter keys and PlantUML identifiers stay in English | +| `codeRoot` | `.` | Where the code lives; used by editions that read or generate code | +| `paths.*` | numbered folders | Folder name of each discipline under `outDir` | +| `useCaseDir` | `use-cases` | Subfolder that holds one folder per use case | +| `plantuml.url` | `http://127.0.0.1:8085` | Address of the PlantUML server | +| `plantuml.timeoutMs` | `30000` | Time allowed for one render request | +| `diagrams.language` | `plantuml` | Diagram language. The free edition supports `plantuml` | +| `diagrams.outputs` | `["svg"]` | Render outputs. The free edition supports `svg` | +| `ids.*` | `RF`, `RNF`, `UC`, `RN`, `DEC`, `TC` | Prefixes of the stable identifiers | +| `targetStack` | empty | Target stack, read by editions that generate code | + +## Precedence + +Flags override the file, and the file overrides the defaults: + +```text +flags > rup.config.json > defaults +``` + +`config` prints the resolved result. + +## Changing paths on an existing project + +Changing `paths` or `outDir` after documents exist means moving the folders and +fixing the links. Do it as one explicit step and run `check` afterwards. + +## Settings that belong to Pro + +The free edition rejects a configuration that asks for a Mermaid diagram +language or a non-`svg` output, and ignores nothing silently: it stops with a +message that names Pro. Theme settings are only read by Pro. diff --git a/docs/contributing/index.md b/docs/contributing/index.md new file mode 100644 index 0000000..66fe6b6 --- /dev/null +++ b/docs/contributing/index.md @@ -0,0 +1,39 @@ +--- +title: Contributing +description: How to improve the rup-flow documentation and the free skill. +--- + +# Contributing + +## The documentation + +This site lives in [rup-flow-docs](https://github.com/hector-ae21/rup-flow-docs). +Work on a branch, run `npm run verify` and open a pull request. + +Rules that keep the site honest: + +- Document released behaviour of the free edition completely. +- Describe Pro at feature level only. A reader must not be able to recreate a Pro + capability from this site. +- Examples contain no credentials or private data. + +## The free skill + +The skill lives in [rup-flow](https://github.com/hector-ae21/rup-flow). Pull +requests improve the free workflow; capabilities listed as Pro in +`editions.json` are developed elsewhere and are not accepted there. + +| Check | Command | +| --- | --- | +| Validation and tests | `npm run check` | +| Package the web ZIP | `node tools/package-web.mjs` | + +Conventional Commits, a branch per change and the `CI complete` check apply to +both repositories. Every behaviour change needs a test and a changelog entry +under `Unreleased`. + +## Reporting a problem + +Open an issue with the documentation template for this site, or a bug report in +the skill repository. Report vulnerabilities privately as described in the +repository security policies. diff --git a/docs/diagrams/analysis-classes.md b/docs/diagrams/analysis-classes.md new file mode 100644 index 0000000..5ffdd80 --- /dev/null +++ b/docs/diagrams/analysis-classes.md @@ -0,0 +1,62 @@ +--- +title: Analysis classes +description: The boundary, control and entity classes of the analysis discipline. +--- + +# Analysis classes + +The first software structure derived from the use cases: what the user touches +(boundary), what coordinates (control) and what holds information (entity). + +
+ +![Analysis classes of the online shop: a checkout screen, a controller and entities](../assets/diagrams/catalogue/analysis-classes.svg) + +
+ +## Source + +```text +@startuml +!theme plain +hide empty members +skinparam linetype polyline +top to bottom direction + +class CheckoutScreen <> +class CreateOrderController <> +class Order <> +class OrderLine <> +class Product <> +class Customer <> + +CheckoutScreen --> CreateOrderController +CreateOrderController --> Order +CreateOrderController --> Product +CreateOrderController --> Customer +Order *-- OrderLine +OrderLine --> Product + +@enduml +``` + +## Stereotypes + +| Stereotype | Role | +| --- | --- | +| `<>` | Interface between the actor and the system: a screen, an endpoint | +| `<>` | Coordination of one use case | +| `<>` | Domain information, taken from the domain model | + +## Conventions + +- Arrows point down, from boundary to control to entity. +- One control class per use case. +- Entity names are the ones in the domain model. + +
+ +**Pro** adds one analysis collaboration per use case, with numbered messages, +and the analysis card that links it to the requirements and the design. + +
diff --git a/docs/diagrams/conventions.md b/docs/diagrams/conventions.md new file mode 100644 index 0000000..962a3d0 --- /dev/null +++ b/docs/diagrams/conventions.md @@ -0,0 +1,54 @@ +--- +title: Diagram conventions +description: How rup-flow diagrams are written so they stay readable. +--- + +# Diagram conventions + +## Header + +Every PlantUML source starts the same way: + +```text +@startuml +!theme plain +hide empty members +hide circle +skinparam linetype polyline +``` + +Use `top to bottom direction` by default. Use `left to right direction` only for +short linear flows of four elements or fewer: wide diagrams shrink to unreadable +text when embedded. + +## No colors in sources + +The free edition renders with the default PlantUML look. Do not write colors or +theme blocks into sources. Palettes are a Pro feature applied when the diagram +is drawn, so the sources stay clean. + +## Avoiding collisions + +1. Keep each diagram to twelve to fifteen elements. Split into views before + squeezing. +2. Group related elements in a `package`. +3. Fix the order of elements with hidden links, for example + `A -[hidden]right-> B`. +4. Hold elements together or apart with `together { … }` and `skinparam nodesep` + or `ranksep` between 50 and 80. +5. Prefer short relation labels; put long text in notes on elements. +6. Write relations with a direction (`Order *-down- OrderLine`). A plain `--` + lets both ends land on the same row. +7. Avoid relations from one hub to everything; introduce a package. +8. If lines still cross badly after two adjustments, split the diagram. + +## Sandbox + +The PlantUML server runs with the `SANDBOX` profile. Diagrams must not use +`!include` of files or addresses. + +## Naming + +PlantUML identifiers are English, without spaces (use `as`), and equal to the +names in the model. A title inside a diagram is optional; the Markdown heading +names the diagram. diff --git a/docs/diagrams/domain-model-simple.md b/docs/diagrams/domain-model-simple.md new file mode 100644 index 0000000..d151e32 --- /dev/null +++ b/docs/diagrams/domain-model-simple.md @@ -0,0 +1,60 @@ +--- +title: Simplified domain model +description: The free domain diagram, how to draw it and how to read it. +--- + +# Simplified domain model + +The business concepts of the project and the relations between them. Attributes +and importance levels are left out; the entity dictionary carries the detail. + +
+ +![Simplified domain model of an online shop with Order, OrderLine, Customer, Product and Address](../assets/diagrams/catalogue/domain-model-simple.svg) + +
+ +## Source + +```text +@startuml +!theme plain +hide empty members +hide circle +skinparam linetype polyline +top to bottom direction + +class Order +class Customer +class OrderLine +class Product +class Address + +Order *-- OrderLine +Customer -- Order +OrderLine --> Product +Order --> Address + +@enduml +``` + +## How to draw it + +- File `00-domain-model/domain-model-simple.puml`. +- Entities and relations only. Choose each relation by meaning: composition only + when the part cannot live without the whole. +- Keep it to twelve entities or fewer; split before squeezing. +- Names are the business terms recorded in the entity dictionary. + +## Companion documents + +`00-domain-model/README.md` holds the entity dictionary (definition, key +attributes, source) and the business rules (`RN-xxx`). + +
+ +**Pro** draws the same model ranked by importance, with attributes and +multiplicities, and adds the lifecycle of the entities whose state changes +behaviour. See the [catalogue](index.md). + +
diff --git a/docs/diagrams/index.md b/docs/diagrams/index.md new file mode 100644 index 0000000..e4247a1 --- /dev/null +++ b/docs/diagrams/index.md @@ -0,0 +1,108 @@ +--- +title: Diagram catalogue +description: Every diagram rup-flow draws, with the three that are free and the eleven that are part of Pro. +--- + +# Diagram catalogue + +rup-flow draws fourteen kinds of diagram. Three are free; they cover the first +disciplines of RUP. The other eleven are part of +[rup-flow Pro](../pro/index.md). The catalogue is the same one the CLI prints +with `RUP editions`. + +## Free + +
+ +
+ +### Simplified domain model + +Entities and relations, nothing else. + +[Read more](domain-model-simple.md) + +
+ +
+ +### Use-case specification + +The Actor/System conversation as a statechart. + +[Read more](specification.md) + +
+ +
+ +### Analysis classes + +Boundary, control and entity classes. + +[Read more](analysis-classes.md) + +
+ +
+ +## Part of Pro + +Images below are rendered by the Pro edition with the default look. + + + +All fourteen can also be drawn in Mermaid, with eight palettes or your own +colors, in Pro. See [Themes, Mermaid and the explorer](../pro/themes-and-explorer.md). diff --git a/docs/diagrams/specification.md b/docs/diagrams/specification.md new file mode 100644 index 0000000..398eb48 --- /dev/null +++ b/docs/diagrams/specification.md @@ -0,0 +1,69 @@ +--- +title: Use-case specification +description: The statechart that holds the behaviour of a use case, how to draw it and how to read it. +--- + +# Use-case specification + +The specification is the behaviour source of truth of a use case: a statechart +of the conversation between the actor and the system. The card describes the +same paths in words; if they diverge, the specification wins and the card is +corrected. + +
+ +![Statechart of the createOrder use case: Basket, Checkout, Validating and Placed](../assets/diagrams/catalogue/specification.svg) + +
+ +## Source + +```text +@startuml +!theme plain +skinparam linetype polyline +hide empty description + +state "createOrder" as createOrder { + state " " as Basket + state " " as Checkout + state " " as Validating + state " " as Placed + + [*] --> Basket + Basket --> Checkout : Customer asks to check out + Checkout --> Validating : Customer confirms address + Validating --> Checkout : System reports unavailable stock or missing address + Validating --> Placed : System creates order and reserves stock + Placed --> [*] + + note on link + Actor: asks to check out + System: shows lines, totals and the address form + end note +} + +@enduml +``` + +## Conventions + +- A composite state named after the use case; inner states have no visible label. +- Transitions are the events of the conversation. +- Notes on transitions narrate what the actor does and what the system answers. +- Error and cancel paths are explicit transitions. +- `skinparam linetype polyline`. + +## Checklist + +- The main flow reaches the goal and every step has a system response. +- Every input and every precondition has a failure path. +- The paths match the flows in the card. + +
+ +**Pro** adds the wireframes of the screens of the flow, the analysis +collaboration and the design sequence for the same use case, each linked from +the card. See the [catalogue](index.md). + +
diff --git a/docs/getting-started/first-documentation.md b/docs/getting-started/first-documentation.md new file mode 100644 index 0000000..caf09f1 --- /dev/null +++ b/docs/getting-started/first-documentation.md @@ -0,0 +1,62 @@ +--- +title: Document your first system +description: Run one prompt, read the documents the free edition writes and check the result. +--- + +# Document your first system + +## The prompt + +```text title="Prompt" +Use rup-flow to document this system in docs/rup, in English: +an online shop where customers place orders for products. +Actor: Customer. Requirement RF-001: a customer can place an order for one or +more products. Rules: an order has at least one line; a line quantity cannot +exceed stock. +``` + +The more you state, the less the agent has to ask. What you do not state is +marked *assumed* or goes to the open questions. + +## What happens + +1. The agent reads `rup.config.json`, or runs `init` to create it. +2. It lists the gaps. Blocking questions (rules that change the model) are asked; + the rest are marked. +3. It writes the domain model, actors, requirements, the use case and the + analysis classes. +4. It renders the diagrams and runs `check`. +5. It reports files created, open questions, checks that were not executed and + the next step. + +## What you get + +```text +docs/rup/ +├── README.md +├── 00-domain-model/ README.md, domain-model-simple.puml/.svg +├── 01-requirements/ README.md, actors.md, requirements.md, use-cases/createOrder/ +├── 02-analysis/ README.md, class-diagram.puml/.svg +└── 05-quality/ open-questions.md +``` + +Open `docs/rup/README.md` and follow the links. A complete rendered example is +in the repository: [examples/shop](https://github.com/hector-ae21/rup-flow/tree/main/examples/shop). + +## Check it yourself + +```console +node scripts/rup.mjs check --root . +``` + +`check` reports broken links, unbalanced diagram sources, missing renders and a +stale use-case index. It does not prove the UML is semantically correct; look at +the rendered images. + +
+ +**Past the first minute:** when you ask for design, traceability or code, the +agent tells you plainly that it is part of [rup-flow Pro](../pro/index.md) and +does not invent it. + +
diff --git a/docs/getting-started/how-it-works.md b/docs/getting-started/how-it-works.md new file mode 100644 index 0000000..fbbb217 --- /dev/null +++ b/docs/getting-started/how-it-works.md @@ -0,0 +1,54 @@ +--- +title: How rup-flow works +description: The parts of rup-flow and what each one is responsible for. +--- + +# How rup-flow works + +```text +you ──► agent ──► SKILL.md + references ──► documents (Markdown) + │ + └──► CLI (rup.mjs) ──► PlantUML server ──► SVG diagrams +``` + +## The skill + +`SKILL.md` holds the operating rules and tells the agent which reference to read +for each request. The references (`methodology`, `domain-model`, `use-cases`, +`diagram-conventions`, `structure`) are loaded on demand so the agent spends its +attention on your project, not on boilerplate. + +The skill is written once in the open +[Agent Skills](https://agentskills.io/specification) format and adapted per +client by small adapters (plugin manifest, installer, instruction files). + +## The CLI + +A dependency-free Node.js program does the mechanical work: + +| It does | Command | +| --- | --- | +| Creates the structure and the configuration | `init`, `new use-case` | +| Keeps the use-case index in sync with the cards | `index` | +| Draws `.puml` sources into `.svg` | `render` | +| Verifies structure, links and diagrams | `check` | +| Writes the block that agents without skills read | `instructions` | + +## The operating rules + +1. Read the configuration first. +2. Mark every statement as confirmed, assumed or open. +3. Never invent permissions, rules, states or attributes. +4. Write where the configuration says. +5. Do not claim a diagram is rendered or checked unless it was. +6. Write documents in your language; keep identifiers in English. +7. Keep one source of truth per artifact. + +See [Provenance marks](../reference/provenance.md) and the +[architecture](../architecture/index.md). + +## Editions + +The same CLI runs both editions. rup-flow Pro adds an extension that the CLI +loads when it is present; without it, the CLI is the free edition. Read +[Editions and the extension point](../architecture/editions.md). diff --git a/docs/getting-started/index.md b/docs/getting-started/index.md new file mode 100644 index 0000000..36d0dc7 --- /dev/null +++ b/docs/getting-started/index.md @@ -0,0 +1,71 @@ +--- +title: Get started +description: Install rup-flow, document a first system and understand how the skill, the CLI and your agent work together. +--- + +# Get started + +rup-flow is a skill: a folder of instructions and a small command line that your +AI coding agent loads on demand. You talk to the agent; the agent follows the +skill and runs the CLI. + +
+ +**What you need:** Node.js 18 or newer and an agent that reads the Agent Skills +format. Docker is optional and only draws the diagrams. + +
+ +## Journey + +
+ +
+ +01 · Install + +### Install rup-flow + +Claude Code, Claude on the web, or any client that reads `.agents/skills`. + +[Choose your client](installation.md) + +
+ +
+ +02 · Document + +### Document your first system + +One prompt, a folder of documents and diagrams, and a check. + +[Run the first prompt](first-documentation.md) + +
+ +
+ +03 · Understand + +### See how it works + +The skill, the CLI, the PlantUML server and what each one is responsible for. + +[Read how it works](how-it-works.md) + +
+ +
+ +## What the free edition produces + +| Discipline | Folder | You get | +| --- | --- | --- | +| Domain model | `00-domain-model` | Simplified diagram, entity dictionary, business rules | +| Requirements | `01-requirements` | Actors, requirements catalogue, use-case cards with a specification statechart | +| Analysis | `02-analysis` | Analysis classes (boundary, control, entity) | +| Quality | `05-quality` | Open questions | + +Design, implementation, traceability, audits and code are part of +[rup-flow Pro](../pro/index.md). diff --git a/docs/getting-started/installation.md b/docs/getting-started/installation.md new file mode 100644 index 0000000..90b57d7 --- /dev/null +++ b/docs/getting-started/installation.md @@ -0,0 +1,67 @@ +--- +title: Install rup-flow +description: Install the free rup-flow skill in Claude Code, Claude on the web, or any agent that reads Agent Skills. +--- + +# Install rup-flow + +Pick the client you use. All of them install the same skill. + +## Check the runtime + +```console +node --version +``` + +The skill needs Node.js 18 or newer. Docker is only needed to draw diagrams +(see [Render and check diagrams](../guides/render-and-check.md)). + +## Choose your client + +=== "Claude Code" + + Add the marketplace and install the plugin: + + ```console + claude plugin marketplace add hector-ae21/rup-flow + claude plugin install rup-flow@rup-flow + ``` + + Then say "Use rup-flow to ..." or run `/rup-flow:rup-flow`. + +=== "Claude on the web" + + 1. Download `rup-flow-skill.zip` from the + [latest release](https://github.com/hector-ae21/rup-flow/releases/latest). + 2. In **Customize → Skills**, upload the ZIP. + + The web sandbox cannot reach a PlantUML server on your machine, so diagrams + stay as `.puml` sources there; render them locally later. + +=== "Codex, Gemini CLI and others" + + ```console + git clone https://github.com/hector-ae21/rup-flow + cd rup-flow + node install.mjs --target agents + ``` + + The skill lands in `.agents/skills/rup-flow` under your home folder. Use + `--project
` to install it for one project only. + +## Verify the installation + +Ask the agent to run the CLI, or run it yourself from the skill folder: + +```console +node scripts/rup.mjs editions +``` + +The first line says `this installation: free`. The list below it shows what +the free edition includes and what is part of Pro. + +## Other agents + +Cursor and GitHub Copilot read instruction files instead of skills. The +`instructions` command writes the block they need; see +[Use another agent](../guides/other-agents.md). diff --git a/docs/guides/document-a-system.md b/docs/guides/document-a-system.md new file mode 100644 index 0000000..f5f3e07 --- /dev/null +++ b/docs/guides/document-a-system.md @@ -0,0 +1,50 @@ +--- +title: Document a system +description: Go from an idea to a reviewed RUP documentation set with the free edition. +--- + +# Document a system + +## 1. State the objective + +One sentence: what the system is for and for whom. The agent restates it before +modelling; correct it there. + +## 2. Answer the blocking questions + +The agent separates questions that change the model (a rule, an actor, a state) +from details. It asks the first kind and continues with the rest marked +*assumed*. Anything you do not answer stays in `05-quality/open-questions.md`. + +## 3. Review the domain model + +Open `00-domain-model/README.md`. Check the entity dictionary and the business +rules. A rule marked *assumed* is a question for you, not a decision. + +## 4. Review the requirements + +`01-requirements/requirements.md` lists functional (`RF-xxx`) and non-functional +(`RNF-xxx`) requirements with their origin and who confirmed them. Each RF should +have at least one use case, and each use case at least one RF. + +## 5. Review each use case + +Open the card. Check the main flow, alternative flows, preconditions and +postconditions. Open `specification.svg`: the card and the diagram must describe +the same paths; if they diverge, the specification wins. + +## 6. Mark what is reviewed + +Change `status` in the front matter from `draft` to `reviewed` for the artifacts +you accepted. The agent never promotes an artifact on its own. + +## 7. Check + +```console +node scripts/rup.mjs check --root . +``` + +## Where the free edition stops + +Design (classes, sequences, data model, deployment), implementation cards, +traceability and audits belong to [rup-flow Pro](../pro/documentation-set.md). diff --git a/docs/guides/index.md b/docs/guides/index.md new file mode 100644 index 0000000..cfee946 --- /dev/null +++ b/docs/guides/index.md @@ -0,0 +1,60 @@ +--- +title: Guides +description: Task-oriented guides for the free edition of rup-flow. +--- + +# Guides + +
+ +
+ +## Document a system + +From an idea to a reviewed documentation set. + +[Read the guide](document-a-system.md) + +
+ +
+ +## Add and change use cases + +Scaffold a card, keep the index fresh, split and merge use cases. + +[Read the guide](use-cases.md) + +
+ +
+ +## Render and check diagrams + +Start the PlantUML server, render, and read the `check` output. + +[Read the guide](render-and-check.md) + +
+ +
+ +## Use another agent + +Codex, Gemini CLI, Cursor and GitHub Copilot. + +[Read the guide](other-agents.md) + +
+ +
+ +## Troubleshooting + +The messages you can meet and what to do. + +[Read the guide](troubleshooting.md) + +
+ +
diff --git a/docs/guides/other-agents.md b/docs/guides/other-agents.md new file mode 100644 index 0000000..0cc93f6 --- /dev/null +++ b/docs/guides/other-agents.md @@ -0,0 +1,46 @@ +--- +title: Use another agent +description: Use rup-flow with Codex, Gemini CLI, Cursor, GitHub Copilot and other clients. +--- + +# Use another agent + +## Clients that read Agent Skills + +Codex, Gemini CLI and other clients that read `.agents/skills` use the skill as +it is: + +```console +git clone https://github.com/hector-ae21/rup-flow +cd rup-flow +node install.mjs --target agents +``` + +Use `--project
` to install into one project, `--force` to replace an +existing install (a backup is kept) and `--list` to see the targets. + +## Clients that read instruction files + +Cursor and GitHub Copilot read instruction files. The `instructions` command +adds or refreshes a delimited block in the file each client loads, without +touching the rest of it: + +```console +node scripts/rup.mjs instructions --target agents,claude,gemini,copilot,cursor --root . +``` + +| Target | File | +| --- | --- | +| `agents` | `AGENTS.md` (Codex, Cursor, Copilot agent, Gemini CLI, Zed, Jules and others) | +| `claude` | `CLAUDE.md` | +| `gemini` | `GEMINI.md` | +| `copilot` | `.github/copilot-instructions.md` | +| `cursor` | `.cursor/rules/rup-flow.mdc` | + +Running it again replaces the block between its markers and never duplicates it. +Use `--skill-path ` when the skill is installed somewhere else. + +## Tested clients + +Claude Code, Claude on the web, Codex and Gemini CLI are tested. Cursor and +Copilot are supported through instruction files. diff --git a/docs/guides/render-and-check.md b/docs/guides/render-and-check.md new file mode 100644 index 0000000..c60705a --- /dev/null +++ b/docs/guides/render-and-check.md @@ -0,0 +1,52 @@ +--- +title: Render and check diagrams +description: Start the PlantUML server, render the diagrams and read the check output. +--- + +# Render and check diagrams + +## Start the server + +Diagrams are PlantUML sources. A local Docker container draws them: + +```console +node scripts/rup.mjs server up --root . +node scripts/rup.mjs health --root . +``` + +`health` renders a test diagram and prints `OK` when the server is usable. Stop +the server with `server down`. + +The container publishes its port on `127.0.0.1` only and runs with the `SANDBOX` +security profile, which blocks file and URL access from diagrams. + +## Render + +```console +node scripts/rup.mjs render --root . +``` + +Each `name.puml` becomes `name.svg` next to it. Up-to-date diagrams are skipped; +use `--force` to redraw everything, or `--path ` to render one folder. A +file with several `@start…/@end…` blocks produces `name-01.svg`, `name-02.svg`. + +## Check + +```console +node scripts/rup.mjs check --root . +``` + +| Message | Meaning | Fix | +| --- | --- | --- | +| `broken link` | A Markdown link points to a file that does not exist | Fix the link or create the file | +| `unbalanced @start/@end` | A diagram source is cut off | Complete the source | +| `no rendered SVG` | A source has no image yet | Run `render` | +| `use-case index is stale` | A card changed since the index was generated | Run `index` | +| `unresolved template placeholder` | A `{{name}}` is still in a document | Fill it in | + +`check --strict` turns warnings into a failing exit code, which suits CI. + +## What `check` does not do + +It validates structure and links. It does not prove that UML is semantically +correct or that lines do not cross. Look at the rendered images. diff --git a/docs/guides/troubleshooting.md b/docs/guides/troubleshooting.md new file mode 100644 index 0000000..0b7125b --- /dev/null +++ b/docs/guides/troubleshooting.md @@ -0,0 +1,42 @@ +--- +title: Troubleshooting +description: Messages you can meet in the free edition and what to do about them. +--- + +# Troubleshooting + +## The server is not reachable + +`PlantUML server not usable at http://127.0.0.1:8085`. Start Docker, then run +`server up` and `health`. If the port is taken, change `plantuml.url` in +`rup.config.json` (the port in it is the one the container publishes). + +## `docker compose failed. Is Docker running?` + +Docker Desktop or the Docker daemon is stopped. Start it and retry. + +## A diagram fails to render + +`PlantUML reported a syntax error in this diagram` names the file in the render +report. Fix the source; do not paste colors or `!include` lines, the server is +sandboxed. + +## `... is part of rup-flow Pro` + +You asked for something this edition does not include: a theme, Mermaid, PNG +previews, the explorer, `scan` and the Pro documents. The message includes the +address of the Pro page. See [Free and Pro compared](../pro/compare.md). + +## Output directory not found + +`check` needs the structure first. Run `init`. + +## The agent invents things + +Remind it of the rules: mark every statement as confirmed, assumed or open, and +send unknown rules to `open-questions.md`. If it improvises past what the free +edition provides, tell it to name what is missing instead. + +## Paths with spaces on Windows + +Quote them: `--root "C:\My Projects\shop"`. diff --git a/docs/guides/use-cases.md b/docs/guides/use-cases.md new file mode 100644 index 0000000..27d86f5 --- /dev/null +++ b/docs/guides/use-cases.md @@ -0,0 +1,53 @@ +--- +title: Add and change use cases +description: Scaffold use-case cards, keep the index generated, and keep cards and specifications consistent. +--- + +# Add and change use cases + +## Add one + +Ask the agent: "Add the use case cancelOrder for the Customer", or run: + +```console +node scripts/rup.mjs new use-case cancelOrder --title "Cancel order" --actor Customer --package Ordering --goal "Cancel an order that has not shipped" --root . +``` + +The command creates the card and the specification diagram, assigns the next +`UC-xxx` identifier and refreshes the index. Names are camelCase: verb plus +object. + +| Flag | Meaning | +| --- | --- | +| `--title` | Human title of the card | +| `--actor` | One or several actors, comma separated | +| `--package` | Group of related use cases | +| `--goal` | The user goal in one sentence | +| `--requirement` | Requirement identifier, `RF-001` by default | +| `--includes`, `--extends` | Names of related use cases | + +## Keep the index fresh + +The requirements `README.md` holds a generated table between the markers +`rup-flow:use-cases`. After editing the front matter of a card, run: + +```console +node scripts/rup.mjs index --root . +``` + +Never edit the block by hand: `check` warns when it is stale. + +## Write a good card + +- One user goal per use case, achievable in one sitting by one primary actor. +- Flows are tables with Actor and System columns; one step is one interaction. +- Every alternative flow names the step where it starts, its condition and where + it ends. +- Postconditions are split into success and failure. +- Anything you did not state goes to **Pending** with the question. + +## Keep card and specification together + +The specification is a statechart of the Actor/System conversation. Error and +cancel paths are explicit transitions. See +[Use-case specification](../diagrams/specification.md). diff --git a/docs/index.md b/docs/index.md new file mode 100644 index 0000000..33edd92 --- /dev/null +++ b/docs/index.md @@ -0,0 +1,151 @@ +--- +title: RUP documentation and code, from your AI coding agent +description: Turn requirements into RUP documentation with your AI coding agent. The free edition covers the basics; rup-flow Pro covers the whole workflow, in both directions. +hide: + - toc +--- + +
+ +
+ +

RUP documentation skill · rup-flow 0.4

+ +# Document your system and build it from the same models + +

rup-flow teaches your AI coding agent to turn requirements +into RUP models and diagrams. The free edition covers the first disciplines. +rup-flow Pro covers the whole workflow, from requirements to code and from +legacy code back to models, with evidence for every claim.

+ +
+ +[Document your first system](getting-started/index.md){ .md-button .md-button--primary } +[See what Pro adds](pro/index.md){ .md-button } + +
+ +
+ Works with the agent you use + Never invents requirements + Node.js only +
+ +
+ +
+ +![rup-flow logo: an organization tree of boxes](assets/brand/rup-flow-logo.png){ .rup-hero-logo loading=eager } + +
+ +
+ +## One workflow, two editions + +

The free edition is a complete, working sample. It +stops where the project gets serious, and tells you so instead of improvising.

+ +
+ +
+ +### Free + +The simplified domain model, actors, requirements, use cases with their +specification statechart, analysis classes and open questions, drawn with +PlantUML. MIT licensed. + +[Start with the free edition](getting-started/index.md) + +
+ +
+ +### Pro + +The ranked domain model, every diagram type, design, implementation and +traceability, code in both directions, themes, Mermaid, the interactive +explorer, stack packs, domain libraries and subagents. + +[Explore Pro](pro/index.md) + +
+ +
+ +### Compared + +Every diagram, document, workflow and tool, marked free or Pro, generated from +the same catalogue the CLI prints. + +[Compare the editions](pro/compare.md) + +
+ +
+ +## Honest by construction + +
+ +
+ +### Every statement has a provenance + +*Confirmed* by you, *assumed* by the agent, or *open* as a question. An +assumption is never written as a fact. + +
+ +
+ +### Unknown rules become questions + +Missing business rules go to `open-questions.md` instead of being invented to +make a document look complete. + +
+ +
+ +### The agent says what it did not do + +Diagrams are not called rendered or checked unless the render ran and the result +was looked at. Anything outside your edition is named, not improvised. + +
+ +
+ +## Your first minute + +
+ +
+ +```text title="Prompt" +Use rup-flow to document this system in docs/rup, in English: +an online shop where customers place orders for products. +``` + +
+ +
+ +The agent asks only what it cannot know, writes the documents, draws the +diagrams and checks the result. Open `docs/rup/README.md` and follow the links. + +[Follow the complete quick start →](getting-started/index.md) + +
+ +
+ +
+ +**Current documentation:** this site describes rup-flow `0.4`. Use the version +selector when you operate another release line so commands and configuration +match the skill you installed. + +
diff --git a/docs/pro/code.md b/docs/pro/code.md new file mode 100644 index 0000000..afcfd52 --- /dev/null +++ b/docs/pro/code.md @@ -0,0 +1,47 @@ +--- +title: Code in both directions +description: What rup-flow Pro does with code - reverse engineering, generation, drift detection and audits. +--- + +# Code in both directions + +## Code to RUP + +Point the agent at a code base and ask for its documentation. Pro inventories the +code, reads the parts that matter and writes the same documentation set, with each +claim marked *observed* and cited as `path:line`. Business rules it cannot read in +the code become questions, not invented requirements. + +## RUP to code + +From reviewed models, Pro generates code and tests that follow the conventions of +your code base, with a trace link from each class or handler to the requirement +and use case it implements. Open questions that affect a use case stop its +generation, and nothing outside the requested use cases is written. + +The agent runs the build, the tests and the linters of your project and reports +the result as it is. Whatever it could not run is reported as unverified. + +## Drift detection + +When code and documentation both exist and may disagree, Pro produces a table of +differences: + +| Kind | Meaning | +| --- | --- | +| Model ahead | The documentation describes something the code does not do yet | +| Code ahead | The code does something the documentation does not mention | +| Conflict | Both exist and disagree | +| Dead | An element that nothing refers to | + +## Audit + +A read-only review of the documentation and its alignment with the code, with +findings that carry evidence, severity, impact and a proposed fix. The review +states which checks it could not execute. + +## Honest limits + +Generated code is only as good as the reviewed models and your tests. The audit +validates structure, links and traceability gaps; it does not prove that UML is +semantically correct. diff --git a/docs/pro/compare.md b/docs/pro/compare.md new file mode 100644 index 0000000..965ead8 --- /dev/null +++ b/docs/pro/compare.md @@ -0,0 +1,98 @@ +--- +title: Free and Pro compared +description: Every diagram, document, workflow and tool of rup-flow, marked free or Pro. +--- + +# Free and Pro compared + +The free edition is a sample of the full workflow: it shows how rup-flow works and gives you the first disciplines. [rup-flow Pro](index.md) is the complete workflow. This table is the catalogue the CLI prints with `RUP editions`. + +## Diagrams + +| | Free | Pro | +| --- | :---: | :---: | +| Simplified domain model | Included | Included | +| Use-case specification (Actor/System statechart) | Included | Included | +| Analysis classes (boundary, control, entity) | Included | Included | +| Domain model ranked by importance, with attributes and multiplicities | — | Included | +| Entity lifecycle (state diagram) | — | Included | +| Use-case diagram with packages, include and extend | — | Included | +| One use-case diagram per actor | — | Included | +| Wireframes for every screen of a use case | — | Included | +| Analysis collaboration per use case | — | Included | +| Design classes | — | Included | +| Design sequence per use case | — | Included | +| Data model | — | Included | +| Components and interfaces | — | Included | +| Deployment | — | Included | + +## RUP documentation + +| | Free | Pro | +| --- | :---: | :---: | +| Domain README: entity dictionary and business rules | Included | Included | +| Actors | Included | Included | +| Requirements catalogue (functional and non-functional) | Included | Included | +| Use-case requirements card | Included | Included | +| Analysis README | Included | Included | +| Open questions | Included | Included | +| Domain hierarchy of levels | — | Included | +| Use-case analysis card | — | Included | +| Use-case design card | — | Included | +| Use-case implementation and tests card | — | Included | +| Design README and project configuration | — | Included | +| Code map | — | Included | +| Project profile | — | Included | +| Traceability table | — | Included | +| Audit report and decision records | — | Included | + +## Workflows + +| | Free | Pro | +| --- | :---: | :---: | +| Requirements to domain, requirements and analysis documents | Included | Included | +| Provenance marks: confirmed, observed, assumed, open | Included | Included | +| Code to RUP (reverse engineering with evidence) | — | Included | +| RUP to code with trace links | — | Included | +| Drift detection between documentation and code | — | Included | +| Audit and review of the documentation | — | Included | +| Architect and reviewer subagents | — | Included | + +## Tooling + +| | Free | Pro | +| --- | :---: | :---: | +| CLI: init, new use-case, index, render, check, instructions | Included | Included | +| PlantUML rendering through a local Docker server | Included | Included | +| Eight palettes, custom colors and fonts | — | Included | +| Mermaid as a second diagram language | — | Included | +| PNG previews | — | Included | +| Interactive explorer (search, relations, PNG and SVG export) | — | Included | +| Stack packs for code generation | — | Included | +| Ready-made domain libraries | — | Included | + +## Keep going + +
+ +
+ +### See what Pro adds + +The areas Pro covers and why they matter. + +[Read the Pro overview](index.md) + +
+ +
+ +### Get Pro + +Where to get it and what you receive. + +[Read how to get Pro](get-pro.md) + +
+ +
diff --git a/docs/pro/documentation-set.md b/docs/pro/documentation-set.md new file mode 100644 index 0000000..a2e3d8a --- /dev/null +++ b/docs/pro/documentation-set.md @@ -0,0 +1,40 @@ +--- +title: The complete documentation set +description: The artifacts rup-flow Pro adds to the free edition, discipline by discipline. +--- + +# The complete documentation set + +Pro writes all six disciplines into the same numbered folders the free edition +uses, so a project moves to Pro without renaming anything. + +| Discipline | Free | Pro adds | +| --- | --- | --- | +| `00-domain-model` | Simplified model, dictionary, rules | The model ranked by importance with attributes and multiplicities, and the lifecycle of entities whose state changes behaviour | +| `01-requirements` | Actors, requirements, use-case card, specification | Use-case diagrams, general and per actor, with packages, include and extend; wireframes for every screen | +| `02-analysis` | Analysis classes | One collaboration per use case and its analysis card | +| `03-design` | — | Design classes, sequence per use case, data model, components, deployment, project configuration | +| `04-implementation` | — | Code map and one implementation and tests card per use case | +| `05-quality` | Open questions | Project profile, traceability table, audit report and decision records | + +## One card per discipline + +Every use case has a card in requirements, analysis, design and implementation. +All four start with the same navigation table, so you move between disciplines +without hunting for files. + +## Traceability + +Each requirement, use case, analysis, design, code location and test sits in one +table. Empty cells are gaps that `check` reports. + +## Consistency + +Pro treats the models as the single source of truth for what they describe. A +change in one artifact is propagated to the dependent ones, and the table is +updated in the same change. + +## Example + +The repository ships a complete example project, an online shop, with every +artifact above. See [Free and Pro compared](compare.md) for the full catalogue. diff --git a/docs/pro/get-pro.md b/docs/pro/get-pro.md new file mode 100644 index 0000000..af98d48 --- /dev/null +++ b/docs/pro/get-pro.md @@ -0,0 +1,53 @@ +--- +title: Get Pro +description: Where to get rup-flow Pro and what you receive. +--- + +# Get Pro + +## What you receive + +- The `rup-flow-pro` skill, as a ZIP and ready for the clients that read Agent + Skills. +- Every update published while your license is active. +- The stack packs, domain libraries and subagents of the release. + +## Where + +rup-flow Pro is listed on [Agensi](https://www.agensi.io), the marketplace for +agent skills. Search for `rup-flow-pro` and follow the listing, which shows the +current price and the latest version. + +## Install it + +The package installs like any skill: + +=== "Claude Code" + + Unzip `rup-flow-pro` into `~/.claude/skills/` (or `.claude/skills/` in a + project) and copy the files in its `agents/` folder to `~/.claude/agents/`. + Then say "Use rup-flow-pro to ...". + +=== "Claude on the web" + + Upload `rup-flow-pro-skill.zip` in **Customize → Skills**. + +=== "Codex, Gemini CLI and others" + + Unzip `rup-flow-pro` into `~/.agents/skills/`. + +Install either the free skill or Pro in a given place, not both: they are the +same skill and the Pro one replaces the free one. + +## Verify + +```console +node scripts/rup.mjs editions +``` + +The first line says `this installation: Pro`, and no item is marked as missing. + +## Updating + +Install the new package over the old one. Your documentation and your +configuration are not touched. Read the changelog first. diff --git a/docs/pro/index.md b/docs/pro/index.md new file mode 100644 index 0000000..bc3ad8c --- /dev/null +++ b/docs/pro/index.md @@ -0,0 +1,89 @@ +--- +title: rup-flow Pro +description: The complete rup-flow workflow, from requirements to code and from code back to models, with every diagram, themes and the interactive explorer. +--- + +# rup-flow Pro + +The free edition gets you through requirements. Pro takes the same project the +rest of the way: models you can trust, code that traces back to them, and +documentation that stays honest as the code changes. + +
+ +**Pro is a separate product.** It is not a fork: it is the free skill with an +extension laid over it, so everything you learned in the free edition applies. +It is described here at feature level; the free documentation covers the shared +parts completely. + +
+ +## What Pro adds + +
+ +
+ +### The complete documentation set + +The ranked domain model, entity lifecycles, use-case diagrams, wireframes, +analysis, design, implementation and quality artifacts, linked by one +navigation table per use case. + +[See the set](documentation-set.md) + +
+ +
+ +### Code in both directions + +Reverse engineering with evidence, code generation with trace links, drift +detection and audits. + +[See the workflows](code.md) + +
+ +
+ +### Themes, Mermaid and the explorer + +Eight palettes or your own colors, Mermaid as a second language, PNG previews +and an interactive explorer. + +[See the look](themes-and-explorer.md) + +
+ +
+ +### Packs, libraries and subagents + +Stack packs, ready domain libraries and two subagents that generate and review +independently. + +[See the extras](packs-and-agents.md) + +
+ +
+ +## See it + +![The interactive explorer: selecting Order highlights its relations](../assets/explorer/explorer-overview.png){ loading=lazy } + +## Is Pro for you? + +| If you ... | Pro gives you | +| --- | --- | +| Document a system before building it | Every discipline in one consistent structure | +| Inherit code nobody documented | Documentation derived from the code, each claim cited with its location | +| Have docs and code that drift apart | A table of differences: model ahead, code ahead, conflict, dead | +| Need a deliverable for a course, a client or an audit | A complete, traceable, consistently styled set | +| Want the agent to build from reviewed models | Code, tests and `@rup` trace links generated from them | + +## Next + +[Free and Pro compared](compare.md) · [Get Pro](get-pro.md) · +[License and support](license-and-support.md) diff --git a/docs/pro/license-and-support.md b/docs/pro/license-and-support.md new file mode 100644 index 0000000..33fcc40 --- /dev/null +++ b/docs/pro/license-and-support.md @@ -0,0 +1,34 @@ +--- +title: License and support +description: The terms of rup-flow Pro and how to get help. +--- + +# License and support + +## License + +The free rup-flow skill is MIT licensed. rup-flow Pro is proprietary. + +| You can | You cannot | +| --- | --- | +| Use it for your own work, including client projects you deliver as an individual | Share, publish, sell or sublicense the package or any part of it | +| Keep and use everything you generate, with no restriction | Use it to build or train a competing product | +| Receive the updates published while your license is active | Give your copy or your access to people without a license | + +A team needs one license per person. The license ends if you breach it; what you +already generated stays yours. The full text ships inside the package as +`LICENSE.md`. + +## Support + +- Questions and defects in the documentation: + [open an issue](https://github.com/hector-ae21/rup-flow-docs/issues). +- Defects in the free edition: [rup-flow issues](https://github.com/hector-ae21/rup-flow/issues). +- Support is best effort and runs through those channels. + +Do not paste Pro package content into public issues. + +## Privacy + +Pro keeps the same posture as the free edition: no account, no analytics and no +remote service. See [Trust and data flow](../architecture/trust-and-data.md). diff --git a/docs/pro/packs-and-agents.md b/docs/pro/packs-and-agents.md new file mode 100644 index 0000000..ed7e1b6 --- /dev/null +++ b/docs/pro/packs-and-agents.md @@ -0,0 +1,42 @@ +--- +title: Packs, libraries and subagents +description: Stack packs, domain libraries and the architect and reviewer subagents included in rup-flow Pro. +--- + +# Packs, libraries and subagents + +## Stack packs + +A stack pack fixes how reviewed models become code for one stack: folder layout, +naming, error handling, persistence mapping and test patterns. The agent reads +the pack that matches your configuration before generating code, and it takes +precedence over the generic mapping. + +| Pack | Stack | +| --- | --- | +| `nestjs-prisma` | TypeScript, NestJS, Prisma and Jest | + +More packs follow in later releases; they are listed in the changelog. + +## Domain libraries + +A domain library is a starting point: a ranked domain model, actors, a list of +use cases, entity lifecycles and the questions to ask before using it. Everything +in a library is marked *assumed*; the agent adapts it to your objective and never +presents it as your requirements. + +| Library | Domain | +| --- | --- | +| `lms` | Learning platforms: courses, enrolment, activities, grading, completion | + +## Subagents + +For clients that support subagents (Claude Code does), Pro includes two: + +| Subagent | Does | +| --- | --- | +| `rup-architect` | Generates and updates the models and generates code from reviewed models | +| `rup-reviewer` | Read-only auditor of the documentation and its alignment with the code | + +They run independently, so the review is not written by the one who wrote the +documents. Without subagents, the review runs as a separate pass. diff --git a/docs/pro/themes-and-explorer.md b/docs/pro/themes-and-explorer.md new file mode 100644 index 0000000..5106d67 --- /dev/null +++ b/docs/pro/themes-and-explorer.md @@ -0,0 +1,58 @@ +--- +title: Themes, Mermaid and the explorer +description: The look and the navigation of rup-flow Pro diagrams - palettes, custom colors, Mermaid, PNG previews and the interactive explorer. +--- + +# Themes, Mermaid and the explorer + +## Palettes and colors + +Diagram sources never carry colors. Pro applies the look when it draws, so the +sources stay clean and one change restyles everything. You choose from eight +palettes, override single colors with your own, and set the font. + + + +## Mermaid + +Choose Mermaid instead of PlantUML as the diagram language of a project. The +same documents, the same structure and the same palettes apply. + +![A domain model drawn in Mermaid](../assets/mermaid/domain-model.svg){ loading=lazy } + +## PNG previews + +A raster preview next to each diagram, for tools that cannot show SVG. + +## The interactive explorer + +One self-contained page with every diagram of the project. Search the text of +all diagrams, select an element to highlight its relations, read the use-case +cards beside the diagrams and export what you see as PNG or SVG. + +![The interactive explorer showing the relations of Order](../assets/explorer/explorer-overview.png){ loading=lazy } + +The explorer needs no server: it opens from the file system and loads nothing +from the network. diff --git a/docs/reference/cli.md b/docs/reference/cli.md new file mode 100644 index 0000000..9d48ee6 --- /dev/null +++ b/docs/reference/cli.md @@ -0,0 +1,113 @@ +--- +title: Command line +description: Every command and flag of the free rup-flow CLI. +--- + +# Command line + +Run the CLI from the project root. `RUP` below stands for +`node /scripts/rup.mjs`, where `` is the folder that +contains `SKILL.md`. + +```console +RUP [arguments] [flags] +``` + +## Commands + +| Command | Effect | +| --- | --- | +| `init` | Create `rup.config.json` and the documentation skeleton. Never overwrites a file. | +| `new use-case ` | Scaffold the requirements card and the specification diagram of a use case, then refresh the index. | +| `index` | Regenerate the use-case index table from the cards. | +| `render` | Draw every `.puml` source into a `.svg` through the PlantUML server. | +| `check` | Verify structure, links and diagrams. | +| `editions` | Print what the free edition includes and what is part of Pro. | +| `instructions --target ` | Add or refresh the rup-flow block in an agent instruction file. | +| `server up` / `server down` | Start or stop the PlantUML container. | +| `health` | Verify that the PlantUML server renders. | +| `config` | Print the resolved configuration. | + +Without a command the CLI prints its usage. + +## Common flags + +| Flag | Meaning | +| --- | --- | +| `--root
` | Project root. Defaults to the current directory. | +| `--out ` | Documentation directory, relative to the root (overrides `outDir`). | +| `--lang ` | Language of the documents (overrides `docLanguage`). | +| `--project ` | Project name used in titles. | +| `--plantuml-url ` | Address of the PlantUML server. | +| `--force` | Redraw diagrams that are up to date. | + +## `init` + +```console +RUP init --out docs/rup --lang es --project shop +``` + +Creates the configuration and the free skeleton. Files that exist are skipped. +The report lists what was created and how many artifacts are available in Pro. + +## `new use-case` + +```console +RUP new use-case createOrder --title "Create order" --actor Customer --package Ordering --goal "Place an order" +``` + +| Flag | Meaning | +| --- | --- | +| `--title ` | Title of the card. Defaults to the name. | +| `--actor ` | Actors, comma separated. Defaults to `Actor`. | +| `--package ` | Package. Defaults to `General`. | +| `--goal ` | The goal in one sentence. | +| `--requirement ` | Requirement identifier. Defaults to `RF-001`. | +| `--includes `, `--extends ` | Names of related use cases. | +| `--id ` | Force the identifier instead of the next free one. | + +The name must be camelCase made of letters and digits. The command fails otherwise. + +## `render` + +```console +RUP render --path docs/rup/00-domain-model --force +``` + +| Flag | Meaning | +| --- | --- | +| `--path ` | Render only this directory. | +| `--force` | Redraw everything. | + +Exit code is `1` when any diagram fails. + +## `check` + +`--strict` makes warnings fail the command. Without it, only errors do. + +## `instructions` + +```console +RUP instructions --target agents,claude,gemini,copilot,cursor +``` + +Without `--target` it lists the targets. `--skill-path ` sets where the +block says the skill lives. + +## `server` + +Needs Docker with Compose. The port comes from `plantuml.url`. + +## Exit codes + +| Code | Meaning | +| --- | --- | +| `0` | Done. | +| `1` | A check failed, a render failed, or the command stopped (invalid input, missing server, a capability that is part of Pro). | + +## Capabilities that are part of Pro + +These flags and commands stop with a message that names Pro and its address: +`themes`, `explore`, `scan`, `--theme`, `--font`, `--font-size`, `--color-*`, +`--preview-png`, `--outputs` with `png` or `html`, and `--diagram-language +mermaid`. See [Free and Pro compared](../pro/compare.md). diff --git a/docs/reference/folder-structure.md b/docs/reference/folder-structure.md new file mode 100644 index 0000000..a57a87c --- /dev/null +++ b/docs/reference/folder-structure.md @@ -0,0 +1,51 @@ +--- +title: Folder structure +description: The default tree the free edition generates and the purpose of each folder. +--- + +# Folder structure + +```text +/ default docs/rup +├── README.md index +├── 00-domain-model/ +│ ├── README.md dictionary and rules +│ └── domain-model-simple.puml/.svg entities and relations only +├── 01-requirements/ +│ ├── README.md generated use-case index +│ ├── actors.md +│ ├── requirements.md RF / RNF +│ └── use-cases// +│ ├── README.md card +│ └── specification.puml/.svg behaviour (source of truth) +├── 02-analysis/ +│ ├── README.md +│ └── class-diagram.puml/.svg +└── 05-quality/ + └── open-questions.md +``` + +A use case is named in camelCase (`createOrder`) and keeps that name as its +folder. + +## What each folder is for + +| Folder | Purpose | +| --- | --- | +| `00-domain-model` | The business concepts, their definitions and the rules that constrain them | +| `01-requirements` | Who uses the system, what it must do, and each use case as a card plus a specification | +| `02-analysis` | The first software structure: boundary, control and entity classes | +| `05-quality` | What is still unknown | + +## Folders created by Pro + +`03-design` and `04-implementation` do not exist in the free edition, and +`05-quality` gains the project profile, traceability table, audit and decision +records. The numbering is kept so a project can move to Pro without renaming +anything. See [The complete documentation set](../pro/documentation-set.md). + +## Sources and renders + +Every diagram is a `.puml` source with its `.svg` next to it. Markdown links to +the SVG with a relative path. `.rup-render-state.json` in the documentation +directory records the last render so unchanged diagrams are skipped. diff --git a/docs/reference/front-matter.md b/docs/reference/front-matter.md new file mode 100644 index 0000000..6cbd8ae --- /dev/null +++ b/docs/reference/front-matter.md @@ -0,0 +1,55 @@ +--- +title: Front matter and identifiers +description: The front-matter keys of every document and the stable identifiers rup-flow assigns. +--- + +# Front matter and identifiers + +## Front matter + +Every Markdown artifact except the index READMEs starts with a block like this: + +```yaml +--- +id: UC-001 +name: createOrder +title: Create order +actor: Customer +package: Ordering +status: draft +origin: requirements +sourceOfTruth: model +requirement: RF-001 +includes: validateStock +extends: +--- +``` + +| Key | Values | Meaning | +| --- | --- | --- | +| `id` | `UC-001` and so on | Stable identifier | +| `name` | camelCase | Use-case folder name | +| `title` | text | Human title | +| `actor` | names, comma separated | Primary actors | +| `package` | text | Group of related use cases | +| `status` | `draft`, `reviewed`, `approved` | Review state; never promoted by the agent | +| `origin` | `requirements` | Where the content came from | +| `sourceOfTruth` | `model` | The model leads; code, if any, must follow it | +| `requirement` | `RF-001` | Requirement the use case serves | +| `includes`, `extends` | use-case names | Relations drawn in use-case diagrams | + +The use-case index and `check` read `id`, `title`, `actor`, `package`, `status`, +`requirement`, `includes` and `extends`. + +## Identifiers + +| Prefix | Meaning | +| --- | --- | +| `RF-001` | Functional requirement | +| `RNF-001` | Non-functional requirement | +| `UC-001` | Use case | +| `RN-001` | Business rule | +| `Q-001` | Open question | + +Never reuse or renumber an identifier. Mark a withdrawn one `retired`. The +prefixes come from `ids` in the [configuration](../configuration/index.md). diff --git a/docs/reference/index.md b/docs/reference/index.md new file mode 100644 index 0000000..fc2e3cc --- /dev/null +++ b/docs/reference/index.md @@ -0,0 +1,60 @@ +--- +title: Reference +description: Exact behaviour of the rup-flow command line, configuration, folder structure, identifiers and provenance marks. +--- + +# Reference + +
+ +
+ +## Command line + +Every command and flag of the free CLI. + +[Read the CLI reference](cli.md) + +
+ +
+ +## Configuration + +`rup.config.json`, key by key, and how flags override it. + +[Read the configuration](../configuration/index.md) + +
+ +
+ +## Folder structure + +The default tree and what lives in each folder. + +[Read the structure](folder-structure.md) + +
+ +
+ +## Front matter and identifiers + +The keys every document carries and the stable IDs. + +[Read the identifiers](front-matter.md) + +
+ +
+ +## Provenance marks + +Confirmed, observed, assumed and open. + +[Read the marks](provenance.md) + +
+ +
diff --git a/docs/reference/provenance.md b/docs/reference/provenance.md new file mode 100644 index 0000000..495ffea --- /dev/null +++ b/docs/reference/provenance.md @@ -0,0 +1,38 @@ +--- +title: Provenance marks +description: How rup-flow marks where each statement of a document comes from. +--- + +# Provenance marks + +Every statement in a document carries one provenance. This is what keeps the +documentation honest. + +| Mark | Meaning | Who sets it | +| --- | --- | --- | +| **confirmed** | You said it | The agent, only for what you stated | +| **observed** | Found in the code, cited as `path:line` | The agent, when it reads code (Pro) | +| **assumed** | Proposed by the agent | The agent | +| **open** | A question | The agent, in `open-questions.md` | + +## Rules + +1. An assumption is never presented as confirmed. +2. An unknown business rule goes to `open-questions.md`, not into the model. +3. The agent never invents permissions, rules, states or attributes to make a + document look complete. +4. An *assumed* item stays assumed until you confirm it. + +## In practice + +The entity dictionary and the business-rule table have a **Source** column. A +rule without a source is *assumed*. Open questions record who asked, when and +what they block. + +
+ +**Observed** claims need code, which is the job of the code-to-RUP workflow in +[rup-flow Pro](../pro/code.md). In the free edition, statements are confirmed, +assumed or open. + +
diff --git a/docs/releases/changelog.md b/docs/releases/changelog.md new file mode 100644 index 0000000..5ab8286 --- /dev/null +++ b/docs/releases/changelog.md @@ -0,0 +1,125 @@ +--- +title: Changelog +description: Changes of the free rup-flow skill, release by release. +--- + +# Changelog + +Changes of the free skill. The format follows [Keep a Changelog](https://keepachangelog.com/) and the project uses [Semantic Versioning](https://semver.org/). + +## Unreleased + +## 0.4.0 + +rup-flow becomes a free edition plus a paid one. This repository now holds the free edition; **rup-flow Pro** is a separate private product that extends it. Releases up to 0.3.3 remain available under the MIT license they were published with. + +### Added + +- `editions` command and `editions.json`: a catalogue of every diagram, document, workflow and tool, marked free or Pro. +- An extension point: when `scripts/pro/index.mjs` is installed next to the CLI, the CLI loads it; the free edition runs without it. +- The full user documentation is now a versioned site, . + +### Changed + +- The free edition keeps the simplified domain model, actors, requirements, the use-case requirements card with its specification statechart, the analysis classes and the open-questions list, rendered with PlantUML in its default look. +- Generated documents and CLI output point to Pro where a capability is not included. +- The documentation moved from the GitHub documentation to the documentation site; the documentation is disabled. + +### Removed (now part of rup-flow Pro) + +- Themes, palettes, colors and fonts; Mermaid; PNG previews; the interactive explorer. +- The ranked domain model, entity lifecycles, use-case diagrams, wireframes, collaborations, design, implementation, quality and traceability artifacts. +- Code to RUP (`scan`), RUP to code, drift detection, audit, and the `rup-architect` and `rup-reviewer` subagents. + +## 0.3.3 + +### Added + +- The generated `claude-plugin` branch carries a square 512 px icon at `.claude-plugin/icon.png`, which the plugin directory asks for. It is drawn by the same code as the SVG icon and exists only in that branch; `main` still has no binary files. + +### Changed + +- The CLI help describes the four cards of a use case, and CONTRIBUTING.md documents the repository branches. + +## 0.3.2 + +### Changed + +- The plugin is published from its own branch, `claude-plugin`, generated on every release tag. It holds only the skill, the two agents and the manifests, so the directory scan no longer reads the installer, tests, workflows or tooling. The repository marketplace installs from that branch. New `tools/build-plugin.mjs` and a publish workflow, with tests. + +## 0.3.1 + +### Changed + +- Removed every name and mechanism the directory scan reads as sensitive data leaving the machine: a variable in the SVG parser, and the release workflow, which now publishes through the official script action with its logic in a tested module. Validation fails if such names or environment reads appear in code, workflows or manifests. + +## 0.3.0 + +### Added + +- One card per discipline for every use case (requirements, analysis, design, implementation and tests), each starting with the same navigation table, plus the implementation card with code and tests tables. +- `index` command and generated block in the requirements README: use-case table with links to every discipline, the general use-case diagram (actors outside the system boundary, use cases grouped in packages, `include` and `extend`) and one diagram per actor. `new use-case` takes `--package`, `--goal`, `--includes` and `--extends`; `check` warns when the index is stale. +- Component diagram template (PlantUML and Mermaid) and its section in the design README. +- Explorer: global search across the text of every diagram, grouping by discipline or by use case, previous and next navigation, links between the diagrams of one use case, a Document tab that renders the cards and follows their links, relation tracing with direct or all-reachable depth, PNG and SVG export, copy source and link, full screen, keyboard shortcuts and richer deep links. + +### Changed + +- The example shop now has four use cases in two packages and two actors, and a component diagram. + +## 0.2.0 + +### Changed + +- The user documentation moved to the GitHub documentation; the README is now a short pitch with install steps that links to it. The repository keeps only the gallery images. + +## 0.1.5 + +### Changed + +- Removed the gallery browser option and turned the repository commands in AGENTS.md into npm scripts, the last two texts the directory scan read as a credential leaving the machine. + +## 0.1.4 + +### Changed + +- Renamed identifiers and literals that the directory scan misread as credential handling (variables named key, the SVG namespace URL, the --chrome option). + +## 0.1.3 + +### Changed + +- The plugin tree has no binary files, no `process.env` reads and no listing-only fields in `plugin.json`, so the directory scan has nothing to report: the icon PNG and explorer screenshots moved to the `docs-assets` branch, the icon and URLs are set in the submission portal, the CLI reads only flags and `rup.config.json`, PlantUML requests live in their own module, and the release workflow no longer runs Node. Validation enforces these rules. Added PRIVACY.md. + +## 0.1.2 + +### Changed + +- Compatibility table: Codex and Gemini CLI are marked as tested by the maintainer; Cursor and Copilot remain untested. + +## 0.1.1 + +### Added + +- Portable across agents: `install.mjs --target claude|agents|codex|all` (installs into `.claude` or the `.agents/skills` location used by Codex and similar clients) and `rup.mjs instructions --target ...` (marked, idempotent blocks for `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, Copilot and Cursor). +- `AGENTS.md` for agents working on the repository, `docs/other-agents.md` with a compatibility table, and `docs/architecture.md` with the layers and how to add a client. +- `SKILL.md` frontmatter now carries `license`, `compatibility` and `metadata`, and validation enforces the Agent Skills naming rules and a single version across files. + +### Fixed + +- Directory validation holds that were avoidable: the Docker server command no longer forwards the whole environment, CI waits for the server through the CLI instead of `curl`, and gallery SVGs have short path lines. +- Release title is the tag alone, and a deleted release can be recreated from its tag with `workflow_dispatch`. + +## 0.1.0 + +### Added + +- `rup-flow` skill: requirements → RUP, code → RUP, RUP → code, sync and audit workflows. +- Fixed documentation structure with configurable output directory, folder names, language and identifier prefixes. +- CLI (`init`, `new use-case`, `scan`, `render`, `check`, `server`, `health`, `config`) with no dependencies. +- PlantUML rendering to SVG through a Docker server (sandbox profile, loopback only). +- Mermaid as an alternative diagram language (`diagrams.language`), rendered by a pinned mermaid-cli container. +- Eight color presets plus custom palettes, fonts and level colors (`theme`), applied at render time. +- `diagrams.outputs`: `svg`, `png` previews and an interactive `explorer.html` (pan, zoom, search, relation highlighting, source, dark view, deep links). +- `explore` and `themes` commands; `tools/build-gallery.mjs` regenerates the documentation images. +- Agents `rup-architect` and `rup-reviewer`. +- Claude Code plugin and marketplace manifests, installer, web ZIP packaging and icon generator. diff --git a/docs/releases/index.md b/docs/releases/index.md new file mode 100644 index 0000000..31b0a37 --- /dev/null +++ b/docs/releases/index.md @@ -0,0 +1,57 @@ +--- +title: Releases +description: Choose the correct rup-flow documentation, understand compatibility and trace immutable releases. +application_line: "0.4" +validated_application_version: "0.4.0" +--- + +# Releases + +This site documents the rup-flow `0.4` release line. The version selector uses +`MAJOR.MINOR`; exact patches appear in the changelog. Separate immutable tags and +GitHub releases identify each approved publication of these pages. + +
+ +
+ +## Match a version + +Understand skill versions, publication revisions, aliases and stable URLs. + +[Read versioning and URLs](versioning.md) + +
+ +
+ +## Review changes + +Find the exact release that introduced a change. + +[Read the changelog](changelog.md) + +
+ +
+ +## Update + +Move to a new version without losing your documentation. + +[Read how to update](updating.md) + +
+ +
+ +## Two editions, two version lines + +| Edition | Version line | Where its changes are recorded | +| --- | --- | --- | +| Free | `0.4.x` | [Changelog](changelog.md) | +| Pro | `1.x`, built on a named free version | The Pro package and its listing | + +This site follows the free edition's line. Pro states the free version it was +built on, and every Pro page here describes capabilities that exist in that +build. diff --git a/docs/releases/updating.md b/docs/releases/updating.md new file mode 100644 index 0000000..9a525f9 --- /dev/null +++ b/docs/releases/updating.md @@ -0,0 +1,45 @@ +--- +title: Update rup-flow +description: Move to a newer rup-flow release without touching your documentation. +--- + +# Update rup-flow + +Your documentation and `rup.config.json` live in your project. The skill lives in +its own folder, so updating it never rewrites your documents. + +## Claude Code + +```console +claude plugin marketplace update rup-flow +claude plugin update rup-flow@rup-flow +``` + +## Other clients + +Run the installer again from an updated clone. It refuses to overwrite an +existing install unless you pass `--force`, and it keeps a backup: + +```console +git pull +node install.mjs --target agents --force +``` + +## Claude on the web + +Upload the new `rup-flow-skill.zip` from the +[latest release](https://github.com/hector-ae21/rup-flow/releases/latest). + +## After updating + +1. Read the [changelog](changelog.md) for the versions you skipped. +2. Run `check` on a project. +3. Run `index` once; the use-case index is regenerated from the cards. + +## Between 0.3 and 0.4 + +Version 0.4 split the project into a free edition and rup-flow Pro. If you used +themes, Mermaid, the explorer, code scanning, design, implementation or +traceability artifacts with 0.3, those are part of Pro now. Files you already +generated stay in your project; the free `check` keeps working on them. Releases +up to 0.3.3 remain available under the MIT license they were published with. diff --git a/docs/releases/versioning.md b/docs/releases/versioning.md new file mode 100644 index 0000000..59deea1 --- /dev/null +++ b/docs/releases/versioning.md @@ -0,0 +1,51 @@ +--- +title: Versioning and URLs +description: Match a rup-flow skill to its MAJOR.MINOR documentation line and audit immutable publication revisions. +--- + +# Versioning and URLs + +Skill versions, documentation lines and publication revisions answer different +questions: + +- **Skill version:** which exact release of the skill is installed? +- **Documentation line:** which compatible `MAJOR.MINOR` contract describes it? +- **Publication revision:** which approved snapshot of these pages produced the + current wording and images? + +## MAJOR.MINOR controls the site + +The version selector and the canonical address use the skill's `MAJOR.MINOR`. +Compatible patches update the same line instead of creating a new copy of the +site. + +```text +Skill line: 0.4.x +Validated skill: 0.4.0 +Version selector: 0.4 +Canonical path: /rup-flow-docs/0.4/ +``` + +## Aliases + +| Alias | Points to | +| --- | --- | +| `latest` | The newest documented line | +| `stable` | The newest documented line that is not a preview | + +The site root redirects to `latest`. + +## Publication revisions + +Each approved publication of these pages gets an immutable tag and a GitHub +release. A later editorial fix is a new revision in the same line; it never +rewrites an earlier one. + +## Which version do I have? + +```console +node scripts/rup.mjs config +``` + +does not print the version; read `metadata.version` in `SKILL.md`, or the +`version` of the plugin manifest. diff --git a/mkdocs.yml b/mkdocs.yml new file mode 100644 index 0000000..00b1725 --- /dev/null +++ b/mkdocs.yml @@ -0,0 +1,148 @@ +site_name: rup-flow +site_description: Turn requirements into RUP documentation and code with your AI coding agent +site_author: Hector Arrechea +site_url: &documentation_root https://hector-ae21.github.io/rup-flow-docs/ +repo_name: hector-ae21/rup-flow-docs +repo_url: https://github.com/hector-ae21/rup-flow-docs +edit_uri: edit/v0.x/docs/ +copyright: Copyright © 2026 Hector Arrechea +strict: true + +theme: + name: material + custom_dir: overrides + language: en + logo: assets/brand/rup-flow-mark.png + favicon: assets/brand/rup-flow-favicon.png + font: false + icon: + repo: fontawesome/brands/github + features: + - content.code.annotate + - content.code.copy + - content.tabs.link + - navigation.indexes + - navigation.instant + - navigation.sections + - navigation.tabs + - navigation.tabs.sticky + - navigation.top + - navigation.tracking + - search.highlight + - search.share + - search.suggest + - toc.follow + palette: + - media: "(prefers-color-scheme: light)" + scheme: default + primary: custom + accent: custom + toggle: + icon: material/weather-night + name: Use dark mode + - media: "(prefers-color-scheme: dark)" + scheme: slate + primary: custom + accent: custom + toggle: + icon: material/weather-sunny + name: Use light mode + +plugins: + - privacy + - search: + lang: en + - tags + +markdown_extensions: + - abbr + - admonition + - attr_list + - def_list + - footnotes + - md_in_html + - toc: + permalink: true + - pymdownx.details + - pymdownx.emoji: + emoji_index: !!python/name:material.extensions.emoji.twemoji + emoji_generator: !!python/name:material.extensions.emoji.to_svg + - pymdownx.highlight: + anchor_linenums: true + line_spans: __span + - pymdownx.inlinehilite + - pymdownx.keys + - pymdownx.snippets: + check_paths: true + - pymdownx.superfences + - pymdownx.tabbed: + alternate_style: true + - pymdownx.tasklist: + custom_checkbox: true + +extra_css: + - assets/stylesheets/extra.css + +extra_javascript: + - assets/javascripts/navigation.js + +extra: + # Mike rewrites site_url to the deployed version's own root, so a template + # cannot use it to reach the site root. This alias of the source site_url + # stays untouched by the version plugin. + documentation_root: *documentation_root + social: + - icon: fontawesome/brands/github + link: https://github.com/hector-ae21/rup-flow + name: rup-flow on GitHub + version: + provider: mike + default: latest + +nav: + - Home: index.md + - Get started: + - Get started overview: getting-started/index.md + - Install rup-flow: getting-started/installation.md + - Document your first system: getting-started/first-documentation.md + - How it works: getting-started/how-it-works.md + - Guides: + - Guides overview: guides/index.md + - Document a system: guides/document-a-system.md + - Add and change use cases: guides/use-cases.md + - Render and check diagrams: guides/render-and-check.md + - Use another agent: guides/other-agents.md + - Troubleshooting: guides/troubleshooting.md + - Reference: + - Reference overview: reference/index.md + - Command line: reference/cli.md + - Configuration: configuration/index.md + - Folder structure: reference/folder-structure.md + - Front matter and identifiers: reference/front-matter.md + - Provenance marks: reference/provenance.md + - Diagrams: + - Diagram catalogue: diagrams/index.md + - Simplified domain model: diagrams/domain-model-simple.md + - Use-case specification: diagrams/specification.md + - Analysis classes: diagrams/analysis-classes.md + - Conventions: diagrams/conventions.md + - Architecture: + - Architecture overview: architecture/index.md + - Editions and the extension point: architecture/editions.md + - Trust and data flow: architecture/trust-and-data.md + - Delivery and branches: architecture/delivery.md + - rup-flow Pro: + - Pro overview: pro/index.md + - Free and Pro compared: pro/compare.md + - The complete documentation set: pro/documentation-set.md + - Code in both directions: pro/code.md + - Themes, Mermaid and the explorer: pro/themes-and-explorer.md + - Packs, libraries and subagents: pro/packs-and-agents.md + - Get Pro: pro/get-pro.md + - License and support: pro/license-and-support.md + - Releases: + - Release overview: releases/index.md + - Changelog: releases/changelog.md + - Versioning and URLs: releases/versioning.md + - Update rup-flow: releases/updating.md + - Contributing: contributing/index.md diff --git a/overrides/main.html b/overrides/main.html new file mode 100644 index 0000000..fad95ef --- /dev/null +++ b/overrides/main.html @@ -0,0 +1,8 @@ +{% extends "base.html" %} + +{% block outdated %} + You are viewing documentation for an older rup-flow release. + + Open the current documentation. + +{% endblock %} diff --git a/overrides/partials/nav-item.html b/overrides/partials/nav-item.html new file mode 100644 index 0000000..bbe32a1 --- /dev/null +++ b/overrides/partials/nav-item.html @@ -0,0 +1,167 @@ +{% macro render_status(nav_item, type) %} + {% set class = "md-status md-status--" ~ type %} + {% if config.extra.status and config.extra.status[type] %} + + + {% else %} + + {% endif %} +{% endmacro %} +{% macro render_title(nav_item) %} + {% if nav_item.typeset %} + + {{ nav_item.typeset.title }} + + {% else %} + {{ nav_item.title }} + {% endif %} +{% endmacro %} +{% macro render_content(nav_item, ref) %} + {% set ref = ref or nav_item %} + {% if nav_item.meta and nav_item.meta.icon %} + {% include ".icons/" ~ nav_item.meta.icon ~ ".svg" %} + {% endif %} + + {{ render_title(ref) }} + {% if nav_item.meta and nav_item.meta.subtitle %} +
+ {{ nav_item.meta.subtitle }} + {% endif %} +
+ {% if nav_item.meta and nav_item.encrypted %} + {{ render_status(nav_item, "encrypted") }} + {% endif %} + {% if nav_item.meta and nav_item.meta.status %} + {{ render_status(nav_item, nav_item.meta.status) }} + {% endif %} +{% endmacro %} +{% macro render_pruned(nav_item, ref) %} + {% set ref = ref or nav_item %} + {% set first = nav_item.children | first %} + {% if first and first.children %} + {{ render_pruned(first, ref) }} + {% else %} +
+ {{ render_content(ref) }} + {% if nav_item.children | length > 0 %} + + {% endif %} + + {% endif %} +{% endmacro %} +{% macro render(nav_item, path, level, parent) %} + {% set class = "md-nav__item" %} + {% if nav_item.active %} + {% set class = class ~ " md-nav__item--active" %} + {% endif %} + {% if nav_item.pages %} + {% if page in nav_item.pages %} + {% set nav_item = page %} + {% endif %} + {% endif %} + {% if nav_item.children %} + {% set _ = namespace(index = none) %} + {% if "navigation.indexes" in features %} + {% for item in nav_item.children %} + {% if item.is_index and _.index is none %} + {% set _.index = item %} + {% endif %} + {% endfor %} + {% endif %} + {% set index = _.index %} + {% if "navigation.tabs" in features %} + {% if level == 1 and nav_item.active %} + {% set class = class ~ " md-nav__item--section" %} + {% set is_section = true %} + {% endif %} + {% if "navigation.sections" in features %} + {% if level == 2 and parent.active %} + {% set class = class ~ " md-nav__item--section" %} + {% set is_section = true %} + {% endif %} + {% endif %} + {% elif "navigation.sections" in features %} + {% if level == 1 %} + {% set class = class ~ " md-nav__item--section" %} + {% set is_section = true %} + {% endif %} + {% endif %} + {% if "navigation.prune" in features %} + {% if not is_section and not nav_item.active %} + {% set class = class ~ " md-nav__item--pruned" %} + {% set is_pruned = true %} + {% endif %} + {% endif %} +
  • + {% if not is_pruned %} + {% set checked = "checked" if nav_item.active %} + {% if "navigation.expand" in features and not checked %} + {% set indeterminate = "md-toggle--indeterminate" %} + {% endif %} + + {% if not index %} + {% set tabindex = "0" if not is_section %} + + {% else %} + {% set class = "md-nav__link--active" if index == page %} + + {% endif %} + + {% else %} + {{ render_pruned(nav_item) }} + {% endif %} +
  • + {% elif nav_item == page %} +
  • + {% set toc = page.toc %} + + {% set first = toc | first %} + {% if first and first.level == 1 %} + {% set toc = first.children %} + {% endif %} + {% if toc %} + + {% endif %} + + {{ render_content(nav_item) }} + + {% if toc %} + {% include "partials/toc.html" %} + {% endif %} +
  • + {% else %} +
  • + + {{ render_content(nav_item) }} + +
  • + {% endif %} +{% endmacro %} diff --git a/package-lock.json b/package-lock.json new file mode 100644 index 0000000..ef1b4c2 --- /dev/null +++ b/package-lock.json @@ -0,0 +1,3342 @@ +{ + "name": "rup-flow-docs", + "version": "0.1.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "rup-flow-docs", + "version": "0.1.0", + "license": "MIT", + "devDependencies": { + "@axe-core/playwright": "4.13.0", + "cspell": "10.3.5", + "html-validate": "11.16.1", + "http-server": "14.1.1", + "markdownlint-cli2": "0.23.3", + "playwright": "1.63.0" + }, + "engines": { + "node": ">=24.8.0" + } + }, + "node_modules/@axe-core/playwright": { + "version": "4.13.0", + "resolved": "https://registry.npmjs.org/@axe-core/playwright/-/playwright-4.13.0.tgz", + "integrity": "sha512-6YLx+kxXu5GJceG4ozFg+33a2EMTdjYwWGloJ3sb9Kta5pp+ZNS53uxGVog5JetIY8s++P5UrtX+cri+u0VAVg==", + "dev": true, + "license": "MPL-2.0", + "dependencies": { + "axe-core": "~4.13.0" + }, + "peerDependencies": { + "playwright-core": ">= 1.0.0" + } + }, + "node_modules/@axe-core/playwright/node_modules/axe-core": { + "version": "4.13.0", + "resolved": "https://registry.npmjs.org/axe-core/-/axe-core-4.13.0.tgz", + "integrity": "sha512-UzGt8zg7Ny8djbYMhxl2zuEevVa7r2gJjYY5Lwr1xM7+XU2nd6CkIWFTVcCIbAP63vSz71NaVyyuSk9lHKcy0A==", + "dev": true, + "license": "MPL-2.0", + "engines": { + "node": ">=4" + } + }, + "node_modules/@cspell/cspell-bundled-dicts": { + "version": "10.3.5", + "resolved": "https://registry.npmjs.org/@cspell/cspell-bundled-dicts/-/cspell-bundled-dicts-10.3.5.tgz", + "integrity": "sha512-gmgpSYyPP1kAZrKVulmJ+lycQUEFG54n2dsMxLfPtBcTpOhvFZUHfyzLmpkukujU8JySOeCSjynEtqIPqzxvUg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@cspell/dict-ada": "^4.1.1", + "@cspell/dict-al": "^1.1.1", + "@cspell/dict-aws": "^4.0.17", + "@cspell/dict-bash": "^4.2.3", + "@cspell/dict-companies": "^3.2.13", + "@cspell/dict-cpp": "^7.1.2", + "@cspell/dict-cryptocurrencies": "^5.0.5", + "@cspell/dict-csharp": "^4.0.8", + "@cspell/dict-css": "^4.1.2", + "@cspell/dict-dart": "^2.3.2", + "@cspell/dict-data-science": "^2.0.16", + "@cspell/dict-django": "^4.1.6", + "@cspell/dict-docker": "^1.1.17", + "@cspell/dict-dotnet": "^5.0.15", + "@cspell/dict-elixir": "^4.0.8", + "@cspell/dict-en_us": "^4.4.40", + "@cspell/dict-en-common-misspellings": "^2.2.2", + "@cspell/dict-en-gb-mit": "^3.1.29", + "@cspell/dict-filetypes": "^3.0.18", + "@cspell/dict-flutter": "^1.1.1", + "@cspell/dict-fonts": "^4.0.6", + "@cspell/dict-fsharp": "^1.1.1", + "@cspell/dict-fullstack": "^3.2.9", + "@cspell/dict-gaming-terms": "^1.1.2", + "@cspell/dict-git": "^3.1.1", + "@cspell/dict-golang": "^6.0.29", + "@cspell/dict-google": "^1.0.9", + "@cspell/dict-haskell": "^4.0.6", + "@cspell/dict-html": "^4.0.16", + "@cspell/dict-html-symbol-entities": "^4.0.5", + "@cspell/dict-java": "^5.0.12", + "@cspell/dict-julia": "^1.1.1", + "@cspell/dict-k8s": "^1.0.13", + "@cspell/dict-kotlin": "^1.1.1", + "@cspell/dict-latex": "^5.1.0", + "@cspell/dict-lorem-ipsum": "^4.0.5", + "@cspell/dict-lua": "^4.0.8", + "@cspell/dict-makefile": "^1.0.5", + "@cspell/dict-markdown": "^2.0.18", + "@cspell/dict-monkeyc": "^1.1.2", + "@cspell/dict-node": "^5.0.9", + "@cspell/dict-npm": "^5.2.50", + "@cspell/dict-php": "^4.1.3", + "@cspell/dict-powershell": "^5.0.17", + "@cspell/dict-public-licenses": "^2.0.16", + "@cspell/dict-python": "^4.5.2", + "@cspell/dict-r": "^2.1.1", + "@cspell/dict-ruby": "^5.1.4", + "@cspell/dict-rust": "^4.1.2", + "@cspell/dict-scala": "^5.0.11", + "@cspell/dict-shell": "^1.2.0", + "@cspell/dict-software-terms": "^5.4.5", + "@cspell/dict-sql": "^2.2.1", + "@cspell/dict-svelte": "^1.0.7", + "@cspell/dict-swift": "^2.0.6", + "@cspell/dict-terraform": "^1.1.4", + "@cspell/dict-typescript": "^3.2.3", + "@cspell/dict-vue": "^3.0.5", + "@cspell/dict-zig": "^1.0.0" + }, + "engines": { + "node": ">=22.18.0" + } + }, + "node_modules/@cspell/cspell-json-reporter": { + "version": "10.3.5", + "resolved": "https://registry.npmjs.org/@cspell/cspell-json-reporter/-/cspell-json-reporter-10.3.5.tgz", + "integrity": "sha512-eB7nQU4pyV9SgT78yfqiaC5IKQkbYPu/3474CqlzKc+uZQ5/J0ujz0JQQgkVlwZf6i0N03mSQr/LI/iLmMWg5g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@cspell/cspell-types": "10.3.5" + }, + "engines": { + "node": ">=22.18.0" + } + }, + "node_modules/@cspell/cspell-performance-monitor": { + "version": "10.3.5", + "resolved": "https://registry.npmjs.org/@cspell/cspell-performance-monitor/-/cspell-performance-monitor-10.3.5.tgz", + "integrity": "sha512-ZcnwB607vx9I4Ap8NFn1gDwRZRHAmU41pBgRW0IO2Dceue4zyEE4Hn7uh8I2ODHY0cgqHkueVjNekG7eUPFQ3A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=22.18.0" + } + }, + "node_modules/@cspell/cspell-pipe": { + "version": "10.3.5", + "resolved": "https://registry.npmjs.org/@cspell/cspell-pipe/-/cspell-pipe-10.3.5.tgz", + "integrity": "sha512-ZeJCIFmak+UQf7DaBVh0mUFZes7NzbVAUtL8Gyhqmn3QBsIlngs75vVKNtS/4Dqf0HvuzDejUTK3TUtx0pwFAg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=22.18.0" + } + }, + "node_modules/@cspell/cspell-resolver": { + "version": "10.3.5", + "resolved": "https://registry.npmjs.org/@cspell/cspell-resolver/-/cspell-resolver-10.3.5.tgz", + "integrity": "sha512-UR+wX7rEUMVpOzBo6jhvIB0r5+mg/ZevtqJlj/haxtZaphNDrfcHEt5RUcofKQ03YU2QhlJearMU9RWiPaR1Ww==", + "dev": true, + "license": "MIT", + "dependencies": { + "global-directory": "^5.0.0" + }, + "engines": { + "node": ">=22.18.0" + } + }, + "node_modules/@cspell/cspell-service-bus": { + "version": "10.3.5", + "resolved": "https://registry.npmjs.org/@cspell/cspell-service-bus/-/cspell-service-bus-10.3.5.tgz", + "integrity": "sha512-MsVtZ1YoiajW3zObXqqr+6rWHQuk97XKdB2Jl+Wv1djGVmLm5zJQ0ME35iK+OwYicswnBzAO9AIMjn2pPamtUQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=22.18.0" + } + }, + "node_modules/@cspell/cspell-types": { + "version": "10.3.5", + "resolved": "https://registry.npmjs.org/@cspell/cspell-types/-/cspell-types-10.3.5.tgz", + "integrity": "sha512-zNnZVIE3+BfSG7CN5kLNSNo4US8066BCqoebrVksqo+5cn1LGPhgEPvM93wZwJ+LwCJRCuObEW+5BWn8+sqAWw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=22.18.0" + } + }, + "node_modules/@cspell/cspell-worker": { + "version": "10.3.5", + "resolved": "https://registry.npmjs.org/@cspell/cspell-worker/-/cspell-worker-10.3.5.tgz", + "integrity": "sha512-3M1iFXpHj3gvcDLS+GDBBlGnW8mfsrgeoHNp9WLRTm5YmOlovyYUNEcmDBdYK5Ji7fvrw4Osxob0W89Ny6id4w==", + "dev": true, + "license": "MIT", + "dependencies": { + "cspell-lib": "10.3.5" + }, + "engines": { + "node": ">=22.18.0" + } + }, + "node_modules/@cspell/dict-ada": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/@cspell/dict-ada/-/dict-ada-4.1.1.tgz", + "integrity": "sha512-E+0YW9RhZod/9Qy2gxfNZiHJjCYFlCdI69br1eviQQWB8yOTJX0JHXLs79kOYhSW0kINPVUdvddEBe6Lu6CjGQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-al": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/@cspell/dict-al/-/dict-al-1.1.1.tgz", + "integrity": "sha512-sD8GCaZetgQL4+MaJLXqbzWcRjfKVp8x+px3HuCaaiATAAtvjwUQ5/Iubiqwfd1boIh2Y1/3EgM3TLQ7Q8e0wQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-aws": { + "version": "4.0.17", + "resolved": "https://registry.npmjs.org/@cspell/dict-aws/-/dict-aws-4.0.17.tgz", + "integrity": "sha512-ORcblTWcdlGjIbWrgKF+8CNEBQiLVKdUOFoTn0KPNkAYnFcdPP0muT4892h7H4Xafh3j72wqB4/loQ6Nti9E/w==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-bash": { + "version": "4.2.3", + "resolved": "https://registry.npmjs.org/@cspell/dict-bash/-/dict-bash-4.2.3.tgz", + "integrity": "sha512-ljUZoKHbDqw5Sx0qpL2qTUlmkmr+vhZH/sCNrNaBZKTbdgiswErSnIF1jRbGmEitJNxHRHWsuZyVgnTGfVO1Yw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@cspell/dict-shell": "1.2.0" + } + }, + "node_modules/@cspell/dict-companies": { + "version": "3.2.13", + "resolved": "https://registry.npmjs.org/@cspell/dict-companies/-/dict-companies-3.2.13.tgz", + "integrity": "sha512-mBJeYzCkiiWgNQxKg7zyQOpFPwcXO4IAzXGbOEFfcQ4Q0G5Fa7Kqd8z+gvnvSK7NPWKJaFmiApC6I0cka02qmQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-cpp": { + "version": "7.1.2", + "resolved": "https://registry.npmjs.org/@cspell/dict-cpp/-/dict-cpp-7.1.2.tgz", + "integrity": "sha512-bkR33oE+ToyD1hwSV4XeEUB9oDkizHRX03CrQfj23tX4VUVbie5vkEHzlKVhcw/Q+fO2dtV/Vz4f6O5M4a2iZQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-cryptocurrencies": { + "version": "5.0.5", + "resolved": "https://registry.npmjs.org/@cspell/dict-cryptocurrencies/-/dict-cryptocurrencies-5.0.5.tgz", + "integrity": "sha512-R68hYYF/rtlE6T/dsObStzN5QZw+0aQBinAXuWCVqwdS7YZo0X33vGMfChkHaiCo3Z2+bkegqHlqxZF4TD3rUA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-csharp": { + "version": "4.0.8", + "resolved": "https://registry.npmjs.org/@cspell/dict-csharp/-/dict-csharp-4.0.8.tgz", + "integrity": "sha512-qmk45pKFHSxckl5mSlbHxmDitSsGMlk/XzFgt7emeTJWLNSTUK//MbYAkBNRtfzB4uD7pAFiKgpKgtJrTMRnrQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-css": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/@cspell/dict-css/-/dict-css-4.1.2.tgz", + "integrity": "sha512-+ylGoKdwZ2sVOCOnU2Eq5wDZx+RaVX3HoKyNHGGsFvhSw6IidQ6tH/mAPKBDofViHJoWCPNlklE0lTr6MDG3QA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-dart": { + "version": "2.3.2", + "resolved": "https://registry.npmjs.org/@cspell/dict-dart/-/dict-dart-2.3.2.tgz", + "integrity": "sha512-sUiLW56t9gfZcu8iR/5EUg+KYyRD83Cjl3yjDEA2ApVuJvK1HhX+vn4e4k4YfjpUQMag8XO2AaRhARE09+/rqw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-data-science": { + "version": "2.0.16", + "resolved": "https://registry.npmjs.org/@cspell/dict-data-science/-/dict-data-science-2.0.16.tgz", + "integrity": "sha512-M72mxv5asuAnORurz4iXRJ+Tw9XBq6eu7D2Ne7biP0Z1RciKGNxXWu9JycA/KlVvK1hAlKj/fANlXhuEWpXKFg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-django": { + "version": "4.1.6", + "resolved": "https://registry.npmjs.org/@cspell/dict-django/-/dict-django-4.1.6.tgz", + "integrity": "sha512-SdbSFDGy9ulETqNz15oWv2+kpWLlk8DJYd573xhIkeRdcXOjskRuxjSZPKfW7O3NxN/KEf3gm3IevVOiNuFS+w==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-docker": { + "version": "1.1.17", + "resolved": "https://registry.npmjs.org/@cspell/dict-docker/-/dict-docker-1.1.17.tgz", + "integrity": "sha512-OcnVTIpHIYYKhztNTyK8ShAnXTfnqs43hVH6p0py0wlcwRIXe5uj4f12n7zPf2CeBI7JAlPjEsV0Rlf4hbz/xQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-dotnet": { + "version": "5.0.15", + "resolved": "https://registry.npmjs.org/@cspell/dict-dotnet/-/dict-dotnet-5.0.15.tgz", + "integrity": "sha512-j2MUKPlzMeDy/mnb1EjmtkX8e6VzZdw60Qyf6vPlp7WZhUwwp2LBlKOWx7+hASjP6k4a0nDpmn77G+4upxvbZA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-elixir": { + "version": "4.0.8", + "resolved": "https://registry.npmjs.org/@cspell/dict-elixir/-/dict-elixir-4.0.8.tgz", + "integrity": "sha512-CyfphrbMyl4Ms55Vzuj+mNmd693HjBFr9hvU+B2YbFEZprE5AG+EXLYTMRWrXbpds4AuZcvN3deM2XVB80BN/Q==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-en_us": { + "version": "4.4.40", + "resolved": "https://registry.npmjs.org/@cspell/dict-en_us/-/dict-en_us-4.4.40.tgz", + "integrity": "sha512-TGyOaWP1dD28GRHH2Lt04ciMZC8Z6UX+5kJsi04pbQHq6uRxv14/bBVCBeSsajUXRZsJYUqXyHaHB9O0ODuFuQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-en-common-misspellings": { + "version": "2.2.2", + "resolved": "https://registry.npmjs.org/@cspell/dict-en-common-misspellings/-/dict-en-common-misspellings-2.2.2.tgz", + "integrity": "sha512-gu0zS7nm0jgVA2EswgWOR8od8wbNYVgcGzo0pGaDqcSkKS4WhABehLOwbyI0NIEVB+ME6SmckLVGk7g+VD1C6A==", + "dev": true, + "license": "CC BY-SA 4.0" + }, + "node_modules/@cspell/dict-en-gb-mit": { + "version": "3.1.29", + "resolved": "https://registry.npmjs.org/@cspell/dict-en-gb-mit/-/dict-en-gb-mit-3.1.29.tgz", + "integrity": "sha512-mInExsCFZui0f9Vg/MToWfQZzwMfPgHX8BCYdZNdXWbYz+jITXcnvssbdUkui/DVbriZVJ74Zu9bv2jOEqTCNA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-filetypes": { + "version": "3.0.18", + "resolved": "https://registry.npmjs.org/@cspell/dict-filetypes/-/dict-filetypes-3.0.18.tgz", + "integrity": "sha512-yU7RKD/x1IWmDLzWeiItMwgV+6bUcU/af23uS0+uGiFUbsY1qWV/D4rxlAAO6Z7no3J2z8aZOkYIOvUrJq0Rcw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-flutter": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/@cspell/dict-flutter/-/dict-flutter-1.1.1.tgz", + "integrity": "sha512-UlOzRcH2tNbFhZmHJN48Za/2/MEdRHl2BMkCWZBYs+30b91mWvBfzaN4IJQU7dUZtowKayVIF9FzvLZtZokc5A==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-fonts": { + "version": "4.0.6", + "resolved": "https://registry.npmjs.org/@cspell/dict-fonts/-/dict-fonts-4.0.6.tgz", + "integrity": "sha512-aR/0csY01dNb0A1tw/UmN9rKgHruUxsYsvXu6YlSBJFu60s26SKr/k1o4LavpHTQ+lznlYMqAvuxGkE4Flliqw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-fsharp": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/@cspell/dict-fsharp/-/dict-fsharp-1.1.1.tgz", + "integrity": "sha512-imhs0u87wEA4/cYjgzS0tAyaJpwG7vwtC8UyMFbwpmtw+/bgss+osNfyqhYRyS/ehVCWL17Ewx2UPkexjKyaBA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-fullstack": { + "version": "3.2.9", + "resolved": "https://registry.npmjs.org/@cspell/dict-fullstack/-/dict-fullstack-3.2.9.tgz", + "integrity": "sha512-diZX+usW5aZ4/b2T0QM/H/Wl9aNMbdODa1Jq0ReBr/jazmNeWjd+PyqeVgzd1joEaHY+SAnjrf/i9CwKd2ZtWQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-gaming-terms": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/@cspell/dict-gaming-terms/-/dict-gaming-terms-1.1.2.tgz", + "integrity": "sha512-9XnOvaoTBscq0xuD6KTEIkk9hhdfBkkvJAIsvw3JMcnp1214OCGW8+kako5RqQ2vTZR3Tnf3pc57o7VgkM0q1Q==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-git": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/@cspell/dict-git/-/dict-git-3.1.1.tgz", + "integrity": "sha512-XvuGVYj9YEu4EzntqyhH8XlTRyy57C6j8oxkIbUQfR2UYzxZGAP77XHl7qY7eC/40r/haDwnBaccyFR6BRmUCg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-golang": { + "version": "6.0.29", + "resolved": "https://registry.npmjs.org/@cspell/dict-golang/-/dict-golang-6.0.29.tgz", + "integrity": "sha512-EZCgfxrr5lPnYQLmSvB6YtpfoDFt2KKxAD4ppq2xGSIgDFXAF7Mv4doiXIFUQaynCBIEfAMl3f/uDfrIUo4fyQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-google": { + "version": "1.0.9", + "resolved": "https://registry.npmjs.org/@cspell/dict-google/-/dict-google-1.0.9.tgz", + "integrity": "sha512-biL65POqialY0i4g6crj7pR6JnBkbsPovB2WDYkj3H4TuC/QXv7Pu5pdPxeUJA6TSCHI7T5twsO4VSVyRxD9CA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-haskell": { + "version": "4.0.6", + "resolved": "https://registry.npmjs.org/@cspell/dict-haskell/-/dict-haskell-4.0.6.tgz", + "integrity": "sha512-ib8SA5qgftExpYNjWhpYIgvDsZ/0wvKKxSP+kuSkkak520iPvTJumEpIE+qPcmJQo4NzdKMN8nEfaeci4OcFAQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-html": { + "version": "4.0.16", + "resolved": "https://registry.npmjs.org/@cspell/dict-html/-/dict-html-4.0.16.tgz", + "integrity": "sha512-9B6/Cpb5YVcYgsEAlKudun1yd4ONllYS/ZibKLYea2apPR+l2vQdARnPrP9kTqa7NUNfRKl7m9Fb6k9rjimnow==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-html-symbol-entities": { + "version": "4.0.5", + "resolved": "https://registry.npmjs.org/@cspell/dict-html-symbol-entities/-/dict-html-symbol-entities-4.0.5.tgz", + "integrity": "sha512-429alTD4cE0FIwpMucvSN35Ld87HCyuM8mF731KU5Rm4Je2SG6hmVx7nkBsLyrmH3sQukTcr1GaiZsiEg8svPA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-java": { + "version": "5.0.12", + "resolved": "https://registry.npmjs.org/@cspell/dict-java/-/dict-java-5.0.12.tgz", + "integrity": "sha512-qPSNhTcl7LGJ5Qp6VN71H8zqvRQK04S08T67knMq9hTA8U7G1sTKzLmBaDOFhq17vNX/+rT+rbRYp+B5Nwza1A==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-julia": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/@cspell/dict-julia/-/dict-julia-1.1.1.tgz", + "integrity": "sha512-WylJR9TQ2cgwd5BWEOfdO3zvDB+L7kYFm0I9u0s9jKHWQ6yKmfKeMjU9oXxTBxIufhCXm92SKwwVNAC7gjv+yA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-k8s": { + "version": "1.0.13", + "resolved": "https://registry.npmjs.org/@cspell/dict-k8s/-/dict-k8s-1.0.13.tgz", + "integrity": "sha512-ELGkS13k7K/NEfVimBSrxVTfqXvOF/Kvxj4I62YxRm8bvHbfoXgrGaOx28lPiNRz+dmu+yYtvuXbnURKtYbC6g==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-kotlin": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/@cspell/dict-kotlin/-/dict-kotlin-1.1.1.tgz", + "integrity": "sha512-J3NzzfgmxRvEeOe3qUXnSJQCd38i/dpF9/t3quuWh6gXM+krsAXP75dY1CzDmS8mrJAlBdVBeAW5eAZTD8g86Q==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-latex": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/@cspell/dict-latex/-/dict-latex-5.1.0.tgz", + "integrity": "sha512-qxT4guhysyBt0gzoliXYEBYinkAdEtR2M7goRaUH0a7ltCsoqqAeEV8aXYRIdZGcV77gYSobvu3jJL038tlPAw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-lorem-ipsum": { + "version": "4.0.5", + "resolved": "https://registry.npmjs.org/@cspell/dict-lorem-ipsum/-/dict-lorem-ipsum-4.0.5.tgz", + "integrity": "sha512-9a4TJYRcPWPBKkQAJ/whCu4uCAEgv/O2xAaZEI0n4y1/l18Yyx8pBKoIX5QuVXjjmKEkK7hi5SxyIsH7pFEK9Q==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-lua": { + "version": "4.0.8", + "resolved": "https://registry.npmjs.org/@cspell/dict-lua/-/dict-lua-4.0.8.tgz", + "integrity": "sha512-N4PkgNDMu9JVsRu7JBS/3E/dvfItRgk9w5ga2dKq+JupP2Y3lojNaAVFhXISh4Y0a6qXDn2clA6nvnavQ/jjLA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-makefile": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/@cspell/dict-makefile/-/dict-makefile-1.0.5.tgz", + "integrity": "sha512-4vrVt7bGiK8Rx98tfRbYo42Xo2IstJkAF4tLLDMNQLkQ86msDlYSKG1ZCk8Abg+EdNcFAjNhXIiNO+w4KflGAQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-markdown": { + "version": "2.0.18", + "resolved": "https://registry.npmjs.org/@cspell/dict-markdown/-/dict-markdown-2.0.18.tgz", + "integrity": "sha512-KLRSwVrwKDz4n7bl2XQjzvaBZbGgx5QKkP5Ok1b24xaO3TpXsLhAbAn1mItvFlI2tF6Rkt83iYjQcYppywuf5Q==", + "dev": true, + "license": "MIT", + "peerDependencies": { + "@cspell/dict-css": "^4.1.2", + "@cspell/dict-html": "^4.0.16", + "@cspell/dict-html-symbol-entities": "^4.0.5", + "@cspell/dict-typescript": "^3.2.3" + } + }, + "node_modules/@cspell/dict-monkeyc": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/@cspell/dict-monkeyc/-/dict-monkeyc-1.1.2.tgz", + "integrity": "sha512-4VzwdSUVqyUVmAKAzMkVwVa7AkvSi1l1OHdQr58MWq4VR4NQDO8sVQSibd2PMxruXTkxJt9UwVQVHgaaVTiV1Q==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-node": { + "version": "5.0.9", + "resolved": "https://registry.npmjs.org/@cspell/dict-node/-/dict-node-5.0.9.tgz", + "integrity": "sha512-hO+ga+uYZ/WA4OtiMEyKt5rDUlUyu3nXMf8KVEeqq2msYvAPdldKBGH7lGONg6R/rPhv53Rb+0Y1SLdoK1+7wQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-npm": { + "version": "5.2.50", + "resolved": "https://registry.npmjs.org/@cspell/dict-npm/-/dict-npm-5.2.50.tgz", + "integrity": "sha512-JZhJb0wrWpqnzDBM1VG8f6zZPRCOo6YMxct0hFhgBnbOTIHQiqZf9S1BSXCRMmmQlAWqFXjKNDp+rf7ZiJcO9w==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-php": { + "version": "4.1.3", + "resolved": "https://registry.npmjs.org/@cspell/dict-php/-/dict-php-4.1.3.tgz", + "integrity": "sha512-41oKzl7rLVrrVZA/Gs0ESnP6KliEX7c+IwaaNmOL3PAoHasFDVEmIFeENIzuDdM12UcHT+MlLkAm3Qw/lS/ERA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-powershell": { + "version": "5.0.17", + "resolved": "https://registry.npmjs.org/@cspell/dict-powershell/-/dict-powershell-5.0.17.tgz", + "integrity": "sha512-khOoIdBgKRk2scnr7888pf70yJ1Tr3RGdnYcAN0MJ2vtaNRKoOTCFc13gXUkNDHwEyhMI1h9oz3KsT180F2amw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-public-licenses": { + "version": "2.0.16", + "resolved": "https://registry.npmjs.org/@cspell/dict-public-licenses/-/dict-public-licenses-2.0.16.tgz", + "integrity": "sha512-EQRrPvEOmwhwWezV+W7LjXbIBjiy6y/shrET6Qcpnk3XANTzfvWflf9PnJ5kId/oKWvihFy0za0AV1JHd03pSQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-python": { + "version": "4.5.2", + "resolved": "https://registry.npmjs.org/@cspell/dict-python/-/dict-python-4.5.2.tgz", + "integrity": "sha512-CFcTDGN/ycn45WXC5ZZ06pG09WbGKMpPm1rkMuqMP98/jwjw3iiK8c0izWRd8x027n1rOZ9kJ8f9Sd+bQ22HJg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@cspell/dict-data-science": "^2.0.16" + } + }, + "node_modules/@cspell/dict-r": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/@cspell/dict-r/-/dict-r-2.1.1.tgz", + "integrity": "sha512-71Ka+yKfG4ZHEMEmDxc6+blFkeTTvgKbKAbwiwQAuKl3zpqs1Y0vUtwW2N4b3LgmSPhV3ODVY0y4m5ofqDuKMw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-ruby": { + "version": "5.1.4", + "resolved": "https://registry.npmjs.org/@cspell/dict-ruby/-/dict-ruby-5.1.4.tgz", + "integrity": "sha512-Slw1dLY/pW5liJ5Fle+MIPphIdleZkIM6STDoXCN7sy298GfbfT34sJTcSZcXzZJVXiCEAvlLp+s1YNr6DuWNg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-rust": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/@cspell/dict-rust/-/dict-rust-4.1.2.tgz", + "integrity": "sha512-O1FHrumYcO+HZti3dHfBPUdnDFkI+nbYK3pxYmiM1sr+G0ebOd6qchmswS0Wsc6ZdEVNiPYJY/gZQR6jfW3uOg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-scala": { + "version": "5.0.11", + "resolved": "https://registry.npmjs.org/@cspell/dict-scala/-/dict-scala-5.0.11.tgz", + "integrity": "sha512-+D59847Y61KZ0MBoXJzBMtOXfFhezEb6ShjvJlL7bnryyy6iBwAfozbz7OJAe+KrEpYm+GlVV7Wy4FmJSgxBag==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-shell": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/@cspell/dict-shell/-/dict-shell-1.2.0.tgz", + "integrity": "sha512-PVctvT22lJ49niMiakO8xieY7ELCAzjSqhejWR7bAMb5AZ9F4WDEs+XdGMnoVHWeXq7K5rcepLPmEJb+37zzIw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-software-terms": { + "version": "5.4.5", + "resolved": "https://registry.npmjs.org/@cspell/dict-software-terms/-/dict-software-terms-5.4.5.tgz", + "integrity": "sha512-5PgLJNdaFKeA6iklB0XXjmgNaoLJJqf54oRTD1raG/mgwojVlRnWE1G7x4QH9Gz07h3B3+lMDv1F57Xxs4jang==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-sql": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/@cspell/dict-sql/-/dict-sql-2.2.1.tgz", + "integrity": "sha512-qDHF8MpAYCf4pWU8NKbnVGzkoxMNrFqBHyG/dgrlic5EQiKANCLELYtGlX5auIMDLmTf1inA0eNtv74tyRJ/vg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-svelte": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/@cspell/dict-svelte/-/dict-svelte-1.0.7.tgz", + "integrity": "sha512-hGZsGqP0WdzKkdpeVLBivRuSNzOTvN036EBmpOwxH+FTY2DuUH7ecW+cSaMwOgmq5JFSdTcbTNFlNC8HN8lhaQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-swift": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/@cspell/dict-swift/-/dict-swift-2.0.6.tgz", + "integrity": "sha512-PnpNbrIbex2aqU1kMgwEKvCzgbkHtj3dlFLPMqW1vSniop7YxaDTtvTUO4zA++ugYAEL+UK8vYrBwDPTjjvSnA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-terraform": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/@cspell/dict-terraform/-/dict-terraform-1.1.4.tgz", + "integrity": "sha512-Ere42ilvMFvQA4GlcN0OKlruMPR6EsvaB+iTHzj2xc+NJGRK64V7yApUcWrOrSgTiM/vhWXPIsK3OMfiAiNdmA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-typescript": { + "version": "3.2.3", + "resolved": "https://registry.npmjs.org/@cspell/dict-typescript/-/dict-typescript-3.2.3.tgz", + "integrity": "sha512-zXh1wYsNljQZfWWdSPYwQhpwiuW0KPW1dSd8idjMRvSD0aSvWWHoWlrMsmZeRl4qM4QCEAjua8+cjflm41cQBg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-vue": { + "version": "3.0.5", + "resolved": "https://registry.npmjs.org/@cspell/dict-vue/-/dict-vue-3.0.5.tgz", + "integrity": "sha512-Mqutb8jbM+kIcywuPQCCaK5qQHTdaByoEO2J9LKFy3sqAdiBogNkrplqUK0HyyRFgCfbJUgjz3N85iCMcWH0JA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dict-zig": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/@cspell/dict-zig/-/dict-zig-1.0.0.tgz", + "integrity": "sha512-XibBIxBlVosU06+M6uHWkFeT0/pW5WajDRYdXG2CgHnq85b0TI/Ks0FuBJykmsgi2CAD3Qtx8UHFEtl/DSFnAQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@cspell/dynamic-import": { + "version": "10.3.5", + "resolved": "https://registry.npmjs.org/@cspell/dynamic-import/-/dynamic-import-10.3.5.tgz", + "integrity": "sha512-qg+KtbuVMP1WPZO6hj9jux1+UuaCUUoQ+/Rqh0G7LIK+72T81lv8tmJMymiCr31Wjd9w3cs0nOYdPZJ9o0ypQQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@cspell/url": "10.3.5", + "import-meta-resolve": "^4.2.0" + }, + "engines": { + "node": ">=22.18.0" + } + }, + "node_modules/@cspell/filetypes": { + "version": "10.3.5", + "resolved": "https://registry.npmjs.org/@cspell/filetypes/-/filetypes-10.3.5.tgz", + "integrity": "sha512-sgRV+O8bROVE9Qn6sTRYERdQ5g0jL6v+pxBLkvvQpiCovk9me7ycIDbY6OkRUiggqQr0uBeo/7lu4GtXyMTn8Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=22.18.0" + } + }, + "node_modules/@cspell/rpc": { + "version": "10.3.5", + "resolved": "https://registry.npmjs.org/@cspell/rpc/-/rpc-10.3.5.tgz", + "integrity": "sha512-+Yei/jfo8anBaRM6eAaV6+W3FvpQX+Ethe+llZRVM4BnSVc8FLoNkTQiZUTrFq85KPDnmAfyI1Q77Fea3rKekA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=22.18.0" + } + }, + "node_modules/@cspell/strong-weak-map": { + "version": "10.3.5", + "resolved": "https://registry.npmjs.org/@cspell/strong-weak-map/-/strong-weak-map-10.3.5.tgz", + "integrity": "sha512-78zH/wgrEJnY4pHmuC2MONaGIp7nQq/eceflF5qIaopnTz9Xn93Tm83BX4Goy1qNXAkgSOuYQibn5hQwx54INw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=22.18.0" + } + }, + "node_modules/@cspell/url": { + "version": "10.3.5", + "resolved": "https://registry.npmjs.org/@cspell/url/-/url-10.3.5.tgz", + "integrity": "sha512-wC2T2Fex2NIAJqZkAZBDAgDrvG9jWdS2DtbcAI+pCu+C/DDZ/2v9BCbE/rz/jy5/KrUUxEDJR+/MW90s7dX7nQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=22.18.0" + } + }, + "node_modules/@html-validate/stylish": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/@html-validate/stylish/-/stylish-6.0.0.tgz", + "integrity": "sha512-d1/lI3qIXhGVJF3+MmKEBn1dRX6U4Z+BDaOdDI3E6SXcO+OQ7hC/3mSo6BIjwQlcuV6NdDOKm6QCrzIQL1EezQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^22.16.0 || >= 24.0.0" + } + }, + "node_modules/@nodelib/fs.scandir": { + "version": "2.1.5", + "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz", + "integrity": "sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@nodelib/fs.stat": "2.0.5", + "run-parallel": "^1.1.9" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/@nodelib/fs.stat": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz", + "integrity": "sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 8" + } + }, + "node_modules/@nodelib/fs.walk": { + "version": "1.2.8", + "resolved": "https://registry.npmjs.org/@nodelib/fs.walk/-/fs.walk-1.2.8.tgz", + "integrity": "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@nodelib/fs.scandir": "2.1.5", + "fastq": "^1.6.0" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/@sidvind/better-ajv-errors": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/@sidvind/better-ajv-errors/-/better-ajv-errors-7.0.0.tgz", + "integrity": "sha512-imVsp5D3KxJ8+uUmu2dsLKnFg3qdX952v/L1gZoCa0NO2ivhQWHMpYM2KmpFrRXHWFjlqkNZ/935nxiTqXEi1A==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^22.12 || >= 24.0" + }, + "peerDependencies": { + "ajv": "^8.0.0" + } + }, + "node_modules/@sindresorhus/merge-streams": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/@sindresorhus/merge-streams/-/merge-streams-4.0.0.tgz", + "integrity": "sha512-tlqY9xq5ukxTUZBmoOp+m61cqwQD5pHJtFY3Mn8CA8ps6yghLH/Hw8UPdqg4OLmFW3IFlcXnQNmo/dh8HzXYIQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/@types/debug": { + "version": "4.1.13", + "resolved": "https://registry.npmjs.org/@types/debug/-/debug-4.1.13.tgz", + "integrity": "sha512-KSVgmQmzMwPlmtljOomayoR89W4FynCAi3E8PPs7vmDVPe84hT+vGPKkJfThkmXs0x0jAaa9U8uW8bbfyS2fWw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/ms": "*" + } + }, + "node_modules/@types/katex": { + "version": "0.16.8", + "resolved": "https://registry.npmjs.org/@types/katex/-/katex-0.16.8.tgz", + "integrity": "sha512-trgaNyfU+Xh2Tc+ABIb44a5AYUpicB3uwirOioeOkNPPbmgRNtcWyDeeFRzjPZENO9Vq8gvVqfhaaXWLlevVwg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/ms": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/@types/ms/-/ms-2.1.0.tgz", + "integrity": "sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/unist": { + "version": "2.0.11", + "resolved": "https://registry.npmjs.org/@types/unist/-/unist-2.0.11.tgz", + "integrity": "sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA==", + "dev": true, + "license": "MIT" + }, + "node_modules/ajv": { + "version": "8.20.0", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz", + "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==", + "dev": true, + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.3", + "fast-uri": "^3.0.1", + "json-schema-traverse": "^1.0.0", + "require-from-string": "^2.0.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/ansi-regex": { + "version": "6.3.0", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.3.0.tgz", + "integrity": "sha512-WpDfL7NO6j7tH88IDBNVdUJxDh9nmCteAVW9dsep846XdwF4naCBK+/tGLX3KJgcpgMRXCFlTM2hKGoK9FsdrQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-regex?sponsor=1" + } + }, + "node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/argparse": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", + "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==", + "dev": true, + "license": "Python-2.0" + }, + "node_modules/array-timsort": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/array-timsort/-/array-timsort-1.0.3.tgz", + "integrity": "sha512-/+3GRL7dDAGEfM6TseQk/U+mi18TU2Ms9I3UlLdUMhz2hbvGNTKdj9xniwXfUqgYhHxRx0+8UnKkvlNwVU+cWQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/async": { + "version": "3.2.6", + "resolved": "https://registry.npmjs.org/async/-/async-3.2.6.tgz", + "integrity": "sha512-htCUDlxyyCLMgaM3xXg0C0LW2xqfuQ6p05pCEIsXuyQ+a1koYKTuBMzRNwmybfLgvJDMd0r1LTn4+E0Ti6C2AA==", + "dev": true, + "license": "MIT" + }, + "node_modules/basic-auth": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/basic-auth/-/basic-auth-2.0.1.tgz", + "integrity": "sha512-NF+epuEdnUYVlGuhaxbbq+dvJttwLnGY+YixlXlME5KpQ5W3CnXA5cVTneY3SPbPDRkcjMbifrwmFYcClgOZeg==", + "dev": true, + "license": "MIT", + "dependencies": { + "safe-buffer": "5.1.2" + }, + "engines": { + "node": ">= 0.8" + } + }, + "node_modules/braces": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz", + "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==", + "dev": true, + "license": "MIT", + "dependencies": { + "fill-range": "^7.1.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/call-bind-apply-helpers": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz", + "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/call-bound": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz", + "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.2", + "get-intrinsic": "^1.3.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/chalk": { + "version": "5.6.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-5.6.2.tgz", + "integrity": "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^12.17.0 || ^14.13 || >=16.0.0" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/chalk-template": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/chalk-template/-/chalk-template-1.1.2.tgz", + "integrity": "sha512-2bxTP2yUH7AJj/VAXfcA+4IcWGdQ87HwBANLt5XxGTeomo8yG0y95N1um9i5StvhT/Bl0/2cARA5v1PpPXUxUA==", + "dev": true, + "license": "MIT", + "dependencies": { + "chalk": "^5.2.0" + }, + "engines": { + "node": ">=14.16" + }, + "funding": { + "url": "https://github.com/chalk/chalk-template?sponsor=1" + } + }, + "node_modules/character-entities": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/character-entities/-/character-entities-2.0.2.tgz", + "integrity": "sha512-shx7oQ0Awen/BRIdkjkvz54PnEEI/EjwXDSIZp86/KKdbafHh1Df/RYGBhn4hbe2+uKC9FnT5UCEdyPz3ai9hQ==", + "dev": true, + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/character-entities-legacy": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/character-entities-legacy/-/character-entities-legacy-3.0.0.tgz", + "integrity": "sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ==", + "dev": true, + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/character-reference-invalid": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/character-reference-invalid/-/character-reference-invalid-2.0.1.tgz", + "integrity": "sha512-iBZ4F4wRbyORVsu0jPV7gXkOsGYjGHPmAyv+HiHG8gi5PtC9KI2j1+v8/tlibRvjoWX027ypmG/n0HtO5t7unw==", + "dev": true, + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "dev": true, + "license": "MIT" + }, + "node_modules/commander": { + "version": "15.0.0", + "resolved": "https://registry.npmjs.org/commander/-/commander-15.0.0.tgz", + "integrity": "sha512-z67u4ZhzCL/Tydu1lJARtEZYWbWaN7oYLHbsuzocr6y4N6WZAagG3RQ4FW61V1/0+jImpj293XfrcYnd1qxtPg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=22.12.0" + } + }, + "node_modules/comment-json": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/comment-json/-/comment-json-5.0.0.tgz", + "integrity": "sha512-uiqLcOiVDJtBP8WGkZHEP+FZIhTzP1dxvn59EfoYUi9gqupjrBWVQkO2atDrbnKPwLeotFYDsuNb26uBMqB+hw==", + "dev": true, + "license": "MIT", + "dependencies": { + "array-timsort": "^1.0.3", + "esprima": "^4.0.1" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/corser": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/corser/-/corser-2.0.1.tgz", + "integrity": "sha512-utCYNzRSQIZNPIcGZdQc92UVJYAhtGAteCFg0yRaFm8f0P+CPtyGyHXJcGXnffjCybUCEx3FQ2G7U3/o9eIkVQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4.0" + } + }, + "node_modules/cspell": { + "version": "10.3.5", + "resolved": "https://registry.npmjs.org/cspell/-/cspell-10.3.5.tgz", + "integrity": "sha512-Ru3hh2mpZ1wRt8NR69rp+kMEks+pHfdskwAdFIw0FtV+G9JUJbXV3B0wCc8A5KbQlhnR3vBeEX81V8chgl5g6g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@cspell/cspell-json-reporter": "10.3.5", + "@cspell/cspell-performance-monitor": "10.3.5", + "@cspell/cspell-pipe": "10.3.5", + "@cspell/cspell-types": "10.3.5", + "@cspell/cspell-worker": "10.3.5", + "@cspell/dynamic-import": "10.3.5", + "@cspell/url": "10.3.5", + "ansi-regex": "^6.3.0", + "chalk": "^6.0.0", + "chalk-template": "^1.1.2", + "commander": "^15.0.0", + "cspell-config-lib": "10.3.5", + "cspell-dictionary": "10.3.5", + "cspell-gitignore": "10.3.5", + "cspell-glob": "10.3.5", + "cspell-io": "10.3.5", + "cspell-lib": "10.3.5", + "flatted": "^3.4.4", + "semver": "^7.8.5", + "tinyglobby": "^0.2.17" + }, + "bin": { + "cspell": "bin.mjs", + "cspell-esm": "bin.mjs" + }, + "engines": { + "node": ">=22.18.0" + }, + "funding": { + "url": "https://github.com/streetsidesoftware/cspell?sponsor=1" + } + }, + "node_modules/cspell-config-lib": { + "version": "10.3.5", + "resolved": "https://registry.npmjs.org/cspell-config-lib/-/cspell-config-lib-10.3.5.tgz", + "integrity": "sha512-eAbLtQL72FOL0I6NKqrLXY8aPsKgL0nLHAJNKBg7lhV1hyiJeF71+8lE4qE0Nipx+OsZIUa6MespTKUwmfXd5A==", + "dev": true, + "license": "MIT", + "dependencies": { + "@cspell/cspell-types": "10.3.5", + "comment-json": "^5.0.0", + "smol-toml": "^1.8.0", + "yaml": "^2.9.0" + }, + "engines": { + "node": ">=22.18.0" + } + }, + "node_modules/cspell-dictionary": { + "version": "10.3.5", + "resolved": "https://registry.npmjs.org/cspell-dictionary/-/cspell-dictionary-10.3.5.tgz", + "integrity": "sha512-rm+HN3dAs0XulakSodra4s6afLAD8KA+DWx8gniakV4JZBjxdKImNqC3W2yDxQJ6Sn+pI3IjSn6lCeQmwtnfXg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@cspell/cspell-performance-monitor": "10.3.5", + "@cspell/cspell-pipe": "10.3.5", + "@cspell/cspell-types": "10.3.5", + "cspell-trie-lib": "10.3.5", + "fast-equals": "^6.0.2" + }, + "engines": { + "node": ">=22.18.0" + } + }, + "node_modules/cspell-gitignore": { + "version": "10.3.5", + "resolved": "https://registry.npmjs.org/cspell-gitignore/-/cspell-gitignore-10.3.5.tgz", + "integrity": "sha512-qQLZw+nfa+Zy2okSm3L8YLbonTKkuESChvCa3MLc1rWNLdYF5Vb5wPmsxna2nm90qEAZJBe41ognN47bHQlgJg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@cspell/url": "10.3.5", + "cspell-glob": "10.3.5", + "cspell-io": "10.3.5" + }, + "bin": { + "cspell-gitignore": "bin.mjs" + }, + "engines": { + "node": ">=22.18.0" + } + }, + "node_modules/cspell-glob": { + "version": "10.3.5", + "resolved": "https://registry.npmjs.org/cspell-glob/-/cspell-glob-10.3.5.tgz", + "integrity": "sha512-2FcPCV3nHIZrrJxt6mfE38trf6TMt8cZWIn/w/fTD6KdX6gK0a7nKlgMcHPj/EByjNTorKBYxj+tG0G0DBcrgQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@cspell/url": "10.3.5", + "picomatch": "^4.0.7" + }, + "engines": { + "node": ">=22.18.0" + } + }, + "node_modules/cspell-grammar": { + "version": "10.3.5", + "resolved": "https://registry.npmjs.org/cspell-grammar/-/cspell-grammar-10.3.5.tgz", + "integrity": "sha512-isBahk4y5BOw12U3Iltb+gejea7gTNhUDE4XOqH/F+38W3HskJL4hRrxA/C8RyT/b+jvu8jy4hKafGzjsuM7oA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@cspell/cspell-pipe": "10.3.5", + "@cspell/cspell-types": "10.3.5" + }, + "bin": { + "cspell-grammar": "bin.mjs" + }, + "engines": { + "node": ">=22.18.0" + } + }, + "node_modules/cspell-io": { + "version": "10.3.5", + "resolved": "https://registry.npmjs.org/cspell-io/-/cspell-io-10.3.5.tgz", + "integrity": "sha512-3rt3Hen3dDixXQtAjzV8oak/HTjGPqkdYckG2tkwu3Lfe0DnasD+dEGasxRu3uaEWGFY0SDIOUzA9+hi7bxCHA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@cspell/cspell-service-bus": "10.3.5", + "@cspell/url": "10.3.5" + }, + "engines": { + "node": ">=22.18.0" + } + }, + "node_modules/cspell-lib": { + "version": "10.3.5", + "resolved": "https://registry.npmjs.org/cspell-lib/-/cspell-lib-10.3.5.tgz", + "integrity": "sha512-4o0vN7WoZheOWtuobmm39NcQ7sFpd/80o+d7W3rrc6TDa1hxGJfMcC35dZhLcsAQKbG45fBcIl1KM/W7MRXzDQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@cspell/cspell-bundled-dicts": "10.3.5", + "@cspell/cspell-performance-monitor": "10.3.5", + "@cspell/cspell-pipe": "10.3.5", + "@cspell/cspell-resolver": "10.3.5", + "@cspell/cspell-types": "10.3.5", + "@cspell/dynamic-import": "10.3.5", + "@cspell/filetypes": "10.3.5", + "@cspell/rpc": "10.3.5", + "@cspell/strong-weak-map": "10.3.5", + "@cspell/url": "10.3.5", + "cspell-config-lib": "10.3.5", + "cspell-dictionary": "10.3.5", + "cspell-glob": "10.3.5", + "cspell-grammar": "10.3.5", + "cspell-io": "10.3.5", + "cspell-trie-lib": "10.3.5", + "env-paths": "^4.0.0", + "gensequence": "^8.0.8", + "import-fresh": "^4.0.0", + "resolve-from": "^5.0.0", + "vscode-languageserver-textdocument": "^1.0.14", + "vscode-uri": "^3.2.0", + "xdg-basedir": "^5.1.0" + }, + "engines": { + "node": ">=22.18.0" + } + }, + "node_modules/cspell-trie-lib": { + "version": "10.3.5", + "resolved": "https://registry.npmjs.org/cspell-trie-lib/-/cspell-trie-lib-10.3.5.tgz", + "integrity": "sha512-lVeiLN9U8EVrfW05BCSkMlSRPNG9RtjEGQD1cnFrrEKk/Af6Z3CJ+Yi2a6y37RTPQv8o6Tl4tBo3uBh+U6MvLQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=22.18.0" + }, + "peerDependencies": { + "@cspell/cspell-types": "10.3.5" + } + }, + "node_modules/cspell/node_modules/chalk": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-6.0.0.tgz", + "integrity": "sha512-2uNTXIuTTxk7ciZgAU1BQcgnchcG0xXnrs6jzkQfj9SsRa9M2s5zE8WT96hS6KmG4MzWHSrvH43DF1m4XRkrFg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=22" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/debug": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/decode-named-character-reference": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/decode-named-character-reference/-/decode-named-character-reference-1.3.0.tgz", + "integrity": "sha512-GtpQYB283KrPp6nRw50q3U9/VfOutZOe103qlN7BPP6Ad27xYnOIWv4lPzo8HCAL+mMZofJ9KEy30fq6MfaK6Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "character-entities": "^2.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/dequal": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/dequal/-/dequal-2.0.3.tgz", + "integrity": "sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/devlop": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/devlop/-/devlop-1.1.0.tgz", + "integrity": "sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA==", + "dev": true, + "license": "MIT", + "dependencies": { + "dequal": "^2.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/dunder-proto": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz", + "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.1", + "es-errors": "^1.3.0", + "gopd": "^1.2.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/entities": { + "version": "8.1.0", + "resolved": "https://registry.npmjs.org/entities/-/entities-8.1.0.tgz", + "integrity": "sha512-kxL7msIffSuh9aaFAMD7rxAIuTRMAHMeBtgHW2yUdWw732ZNh4MehkF2gdjvtdmikkaIP9bFDDJOPlsvm7avrA==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=20.19.0" + }, + "funding": { + "url": "https://github.com/fb55/entities?sponsor=1" + } + }, + "node_modules/env-paths": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/env-paths/-/env-paths-4.0.0.tgz", + "integrity": "sha512-pxP8eL2SwwaTRi/KHYwLYXinDs7gL3jxFcBYmEdYfZmZXbaVDvdppd0XBU8qVz03rDfKZMXg1omHCbsJjZrMsw==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-safe-filename": "^0.1.0" + }, + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/es-define-property": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz", + "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-errors": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz", + "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/es-object-atoms": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.2.tgz", + "integrity": "sha512-HWcBoN6NileqtSydK2FqHbS/LoDd2pqrnQHLyJzBj4kOp/ky2MWMN694xOfkK8/SnUsW2DH7EfyVlydKCsm1Zw==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/esprima": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz", + "integrity": "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==", + "dev": true, + "license": "BSD-2-Clause", + "bin": { + "esparse": "bin/esparse.js", + "esvalidate": "bin/esvalidate.js" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/eventemitter3": { + "version": "4.0.7", + "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-4.0.7.tgz", + "integrity": "sha512-8guHBZCwKnFhYdHr2ysuRWErTwhoN2X8XELRlrRwpmfeY2jjuUN4taQMsULKUVo1K4DvZl+0pgfyoysHxvmvEw==", + "dev": true, + "license": "MIT" + }, + "node_modules/fast-deep-equal": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz", + "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==", + "dev": true, + "license": "MIT" + }, + "node_modules/fast-equals": { + "version": "6.0.4", + "resolved": "https://registry.npmjs.org/fast-equals/-/fast-equals-6.0.4.tgz", + "integrity": "sha512-JiBeR0k76FIahi9zAtQR7X1jgZDKLE+fs5S9ryjOGYZWZCOcm8QiwgeahkFvaboS3i6PkGBopRznHKuKhm9zpg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/fast-glob": { + "version": "3.3.3", + "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.3.tgz", + "integrity": "sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@nodelib/fs.stat": "^2.0.2", + "@nodelib/fs.walk": "^1.2.3", + "glob-parent": "^5.1.2", + "merge2": "^1.3.0", + "micromatch": "^4.0.8" + }, + "engines": { + "node": ">=8.6.0" + } + }, + "node_modules/fast-uri": { + "version": "3.1.7", + "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.7.tgz", + "integrity": "sha512-dOvZVzjdZdz7phd9v6jCbwxrBW3fK6n8Rc0CtdmM4bumzMnxywBYhuph6J819RRw/ku+rLbelwfMunktuzVVHg==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "BSD-3-Clause" + }, + "node_modules/fastq": { + "version": "1.20.3", + "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.20.3.tgz", + "integrity": "sha512-XKv5nnLs6nLF71NgiKJLIZFLkPyIEuOselLG7ujZnGrRfQK8HpvY+WqKhAJUAdLomwVHErVS4LfxFlPq0/FTAw==", + "dev": true, + "license": "ISC", + "dependencies": { + "reusify": "^1.0.4" + } + }, + "node_modules/fdir": { + "version": "6.5.0", + "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz", + "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12.0.0" + }, + "peerDependencies": { + "picomatch": "^3 || ^4" + }, + "peerDependenciesMeta": { + "picomatch": { + "optional": true + } + } + }, + "node_modules/fill-range": { + "version": "7.1.1", + "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz", + "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==", + "dev": true, + "license": "MIT", + "dependencies": { + "to-regex-range": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/flatted": { + "version": "3.4.4", + "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.4.4.tgz", + "integrity": "sha512-5+ybhBZANEJxaH3X5evAFatUxLfEHSr7n6kYJ+1Qd0mUqr4eu9gIf6GDbWHf8RJijHrjjO8G+la14SlL2SeS1Q==", + "dev": true, + "license": "ISC" + }, + "node_modules/follow-redirects": { + "version": "1.16.0", + "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.16.0.tgz", + "integrity": "sha512-y5rN/uOsadFT/JfYwhxRS5R7Qce+g3zG97+JrtFZlC9klX/W5hD7iiLzScI4nZqUS7DNUdhPgw4xI8W2LuXlUw==", + "dev": true, + "funding": [ + { + "type": "individual", + "url": "https://github.com/sponsors/RubenVerborgh" + } + ], + "license": "MIT", + "engines": { + "node": ">=4.0" + }, + "peerDependenciesMeta": { + "debug": { + "optional": true + } + } + }, + "node_modules/function-bind": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz", + "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==", + "dev": true, + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/gensequence": { + "version": "8.0.8", + "resolved": "https://registry.npmjs.org/gensequence/-/gensequence-8.0.8.tgz", + "integrity": "sha512-omMVniXEXpdx/vKxGnPRoO2394Otlze28TyxECbFVyoSpZ9H3EO7lemjcB12OpQJzRW4e5tt/dL1rOxry6aMHg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=20" + } + }, + "node_modules/get-east-asian-width": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/get-east-asian-width/-/get-east-asian-width-1.6.0.tgz", + "integrity": "sha512-QRbvDIbx6YklUe6RxeTeleMR0yv3cYH6PsPZHcnVn7xv7zO1BHN8r0XETu8n6Ye3Q+ahtSarc3WgtNWmehIBfA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/get-intrinsic": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz", + "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bind-apply-helpers": "^1.0.2", + "es-define-property": "^1.0.1", + "es-errors": "^1.3.0", + "es-object-atoms": "^1.1.1", + "function-bind": "^1.1.2", + "get-proto": "^1.0.1", + "gopd": "^1.2.0", + "has-symbols": "^1.1.0", + "hasown": "^2.0.2", + "math-intrinsics": "^1.1.0" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/get-proto": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz", + "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==", + "dev": true, + "license": "MIT", + "dependencies": { + "dunder-proto": "^1.0.1", + "es-object-atoms": "^1.0.0" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/glob-parent": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz", + "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==", + "dev": true, + "license": "ISC", + "dependencies": { + "is-glob": "^4.0.1" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/global-directory": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/global-directory/-/global-directory-5.0.0.tgz", + "integrity": "sha512-1pgFdhK3J2LeM+dVf2Pd424yHx2ou338lC0ErNP2hPx4j8eW1Sp0XqSjNxtk6Tc4Kr5wlWtSvz8cn2yb7/SG/w==", + "dev": true, + "license": "MIT", + "dependencies": { + "ini": "6.0.0" + }, + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/globby": { + "version": "16.2.4", + "resolved": "https://registry.npmjs.org/globby/-/globby-16.2.4.tgz", + "integrity": "sha512-c8B/VNLmxRcmqqenRA9t+9IyOjf9+V6lTxPaUJLqOCONdQkWZ0ETYgX0qbtJqPsgCNusT9MZ5Jeidw8Eb9tn2g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@sindresorhus/merge-streams": "^4.0.0", + "fast-glob": "^3.3.3", + "ignore": "^7.0.5", + "is-path-inside": "^4.0.0", + "micromatch": "^4.0.8", + "slash": "^5.1.0", + "unicorn-magic": "^0.4.0" + }, + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/gopd": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz", + "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/has-symbols": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz", + "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/hasown": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.4.tgz", + "integrity": "sha512-T2UbfbBEF32wiepXIsMlTW9+dDYC6wMh/t/vYA4tuOMKqWz/n3vr1NFSxQiyP+zk2mXsoMA/i/7qV6LKut1t1A==", + "dev": true, + "license": "MIT", + "dependencies": { + "function-bind": "^1.1.2" + }, + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/he": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/he/-/he-1.2.0.tgz", + "integrity": "sha512-F/1DnUGPopORZi0ni+CvrCgHQ5FyEAHRLSApuYWMmrbSwoN2Mn/7k+Gl38gJnR7yyDZk6WLXwiGod1JOWNDKGw==", + "dev": true, + "license": "MIT", + "bin": { + "he": "bin/he" + } + }, + "node_modules/html-encoding-sniffer": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/html-encoding-sniffer/-/html-encoding-sniffer-3.0.0.tgz", + "integrity": "sha512-oWv4T4yJ52iKrufjnyZPkrN0CH3QnrUqdB6In1g5Fe1mia8GmF36gnfNySxoZtxD5+NmYw1EElVXiBk93UeskA==", + "dev": true, + "license": "MIT", + "dependencies": { + "whatwg-encoding": "^2.0.0" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/html-validate": { + "version": "11.16.1", + "resolved": "https://registry.npmjs.org/html-validate/-/html-validate-11.16.1.tgz", + "integrity": "sha512-PklC0d9tLeXpvC6INePZcTBlXplZOmBkR0IQTYoJ9TSrtqxBKR74lMdKPXcnOImD4mAdp/L5/QJR/x6WrvDYvA==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/html-validate" + } + ], + "license": "MIT", + "dependencies": { + "@html-validate/stylish": "^6.0.0", + "@sidvind/better-ajv-errors": "7.0.0", + "ajv": "^8.0.0", + "kleur": "^4.1.0", + "prompts": "^2.0.0", + "semver": "^7.0.0" + }, + "bin": { + "html-validate": "bin/html-validate.mjs" + }, + "engines": { + "node": "^22.22.0 || >= 24.8.0" + }, + "peerDependencies": { + "@jest/globals": "^29.0.3 || ^30.0.0", + "@vitest/expect": "^3.2.0 || ^4.0.1 || ^5.0.0", + "jest": "^29.0.3 || ^30.0.0", + "jest-snapshot": "^29.0.3 || ^30.0.0", + "vitest": "^3.2.0 || ^4.0.1 || ^5.0.0" + }, + "peerDependenciesMeta": { + "@jest/globals": { + "optional": true + }, + "@vitest/expect": { + "optional": true + }, + "jest": { + "optional": true + }, + "jest-snapshot": { + "optional": true + }, + "vitest": { + "optional": true + } + } + }, + "node_modules/http-proxy": { + "version": "1.18.1", + "resolved": "https://registry.npmjs.org/http-proxy/-/http-proxy-1.18.1.tgz", + "integrity": "sha512-7mz/721AbnJwIVbnaSv1Cz3Am0ZLT/UBwkC92VlxhXv/k/BBQfM2fXElQNC27BVGr0uwUpplYPQM9LnaBMR5NQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "eventemitter3": "^4.0.0", + "follow-redirects": "^1.0.0", + "requires-port": "^1.0.0" + }, + "engines": { + "node": ">=8.0.0" + } + }, + "node_modules/http-server": { + "version": "14.1.1", + "resolved": "https://registry.npmjs.org/http-server/-/http-server-14.1.1.tgz", + "integrity": "sha512-+cbxadF40UXd9T01zUHgA+rlo2Bg1Srer4+B4NwIHdaGxAGGv59nYRnGGDJ9LBk7alpS0US+J+bLLdQOOkJq4A==", + "dev": true, + "license": "MIT", + "dependencies": { + "basic-auth": "^2.0.1", + "chalk": "^4.1.2", + "corser": "^2.0.1", + "he": "^1.2.0", + "html-encoding-sniffer": "^3.0.0", + "http-proxy": "^1.18.1", + "mime": "^1.6.0", + "minimist": "^1.2.6", + "opener": "^1.5.1", + "portfinder": "^1.0.28", + "secure-compare": "3.0.1", + "union": "~0.5.0", + "url-join": "^4.0.1" + }, + "bin": { + "http-server": "bin/http-server" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/http-server/node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/iconv-lite": { + "version": "0.6.3", + "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.6.3.tgz", + "integrity": "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==", + "dev": true, + "license": "MIT", + "dependencies": { + "safer-buffer": ">= 2.1.2 < 3.0.0" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/ignore": { + "version": "7.0.9", + "resolved": "https://registry.npmjs.org/ignore/-/ignore-7.0.9.tgz", + "integrity": "sha512-brTTsvFRt5C1gGHtPst/281UjPD5t9fBqbgoMPlVWy11ZLTPfu7HxK4ZYqO9H7o/yC9rSTCI85EaQ4OoY12qYw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 4" + } + }, + "node_modules/import-fresh": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-4.0.1.tgz", + "integrity": "sha512-/XFeXYgkuWgbtqPC7qPKvciXTvhtz7WMNQKQsAM1Kz+j0I5OWJDrybfiya6QtHF9oEvPkLwTHmC9+4OR/MmfIA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=22.15" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/import-meta-resolve": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/import-meta-resolve/-/import-meta-resolve-4.2.0.tgz", + "integrity": "sha512-Iqv2fzaTQN28s/FwZAoFq0ZSs/7hMAHJVX+w8PZl3cY19Pxk6jFFalxQoIfW2826i/fDLXv8IiEZRIT0lDuWcg==", + "dev": true, + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/ini": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/ini/-/ini-6.0.0.tgz", + "integrity": "sha512-IBTdIkzZNOpqm7q3dRqJvMaldXjDHWkEDfrwGEQTs5eaQMWV+djAhR+wahyNNMAa+qpbDUhBMVt4ZKNwpPm7xQ==", + "dev": true, + "license": "ISC", + "engines": { + "node": "^20.17.0 || >=22.9.0" + } + }, + "node_modules/is-alphabetical": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/is-alphabetical/-/is-alphabetical-2.0.1.tgz", + "integrity": "sha512-FWyyY60MeTNyeSRpkM2Iry0G9hpr7/9kD40mD/cGQEuilcZYS4okz8SN2Q6rLCJ8gbCt6fN+rC+6tMGS99LaxQ==", + "dev": true, + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/is-alphanumerical": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/is-alphanumerical/-/is-alphanumerical-2.0.1.tgz", + "integrity": "sha512-hmbYhX/9MUMF5uh7tOXyK/n0ZvWpad5caBA17GsC6vyuCqaWliRG5K1qS9inmUhEMaOBIW7/whAnSwveW/LtZw==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-alphabetical": "^2.0.0", + "is-decimal": "^2.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/is-decimal": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/is-decimal/-/is-decimal-2.0.1.tgz", + "integrity": "sha512-AAB9hiomQs5DXWcRB1rqsxGUstbRroFOPPVAomNk/3XHR5JyEZChOyTWe2oayKnsSsr/kcGqF+z6yuH6HHpN0A==", + "dev": true, + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/is-extglob": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz", + "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-glob": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz", + "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-extglob": "^2.1.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-hexadecimal": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/is-hexadecimal/-/is-hexadecimal-2.0.1.tgz", + "integrity": "sha512-DgZQp241c8oO6cA1SbTEWiXeoxV42vlcJxgH+B3hi1AiqqKruZR3ZGF8In3fj4+/y/7rHvlOZLZtgJ/4ttYGZg==", + "dev": true, + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/is-number": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz", + "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.12.0" + } + }, + "node_modules/is-path-inside": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/is-path-inside/-/is-path-inside-4.0.0.tgz", + "integrity": "sha512-lJJV/5dYS+RcL8uQdBDW9c9uWFLLBNRyFhnAKXw5tVqLlKZ4RMGZKv+YQ/IA3OhD+RpbJa1LLFM1FQPGyIXvOA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/is-safe-filename": { + "version": "0.1.1", + "resolved": "https://registry.npmjs.org/is-safe-filename/-/is-safe-filename-0.1.1.tgz", + "integrity": "sha512-4SrR7AdnY11LHfDKTZY1u6Ga3RuxZdl3YKWWShO5iyuG5h8QS4GD2tOb04peBJ5I7pXbR+CGBNEhTcwK+FzN3g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/js-yaml": { + "version": "5.4.1", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-5.4.1.tgz", + "integrity": "sha512-28R/k+NAjeuf7+CKlTxWZVExJGwVVLwY06DgEnOMz2gEpfNkDcD7QvyiVPT0xy0XXhU8vHsd4Ot42OOPdJG7dQ==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/puzrin" + }, + { + "type": "github", + "url": "https://github.com/sponsors/nodeca" + } + ], + "license": "MIT", + "dependencies": { + "argparse": "^2.0.1" + }, + "bin": { + "js-yaml": "bin/js-yaml.mjs" + } + }, + "node_modules/json-schema-traverse": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz", + "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==", + "dev": true, + "license": "MIT" + }, + "node_modules/jsonc-parser": { + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/jsonc-parser/-/jsonc-parser-3.3.1.tgz", + "integrity": "sha512-HUgH65KyejrUFPvHFPbqOY0rsFip3Bo5wb4ngvdi1EpCYWUQDC5V+Y7mZws+DLkr4M//zQJoanu1SP+87Dv1oQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/jsonpointer": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/jsonpointer/-/jsonpointer-5.0.1.tgz", + "integrity": "sha512-p/nXbhSEcu3pZRdkW1OfJhpsVtW1gd4Wa1fnQc9YLiTfAjn0312eMKimbdIQzuZl9aa9xUGaRlP9T/CJE/ditQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/katex": { + "version": "0.16.47", + "resolved": "https://registry.npmjs.org/katex/-/katex-0.16.47.tgz", + "integrity": "sha512-Eeo8Ys1doU1z+x8AZsPpQu+p/QcZBI5PeOo7QGQdy2x2m0MU/hYagBbGOmXwr5KVbEfVuWv9LpnQWeehogurjg==", + "dev": true, + "funding": [ + "https://opencollective.com/katex", + "https://github.com/sponsors/katex" + ], + "license": "MIT", + "dependencies": { + "commander": "^8.3.0" + }, + "bin": { + "katex": "cli.js" + } + }, + "node_modules/katex/node_modules/commander": { + "version": "8.3.0", + "resolved": "https://registry.npmjs.org/commander/-/commander-8.3.0.tgz", + "integrity": "sha512-OkTL9umf+He2DZkUq8f8J9of7yL6RJKI24dVITBmNfZBmri9zYZQrKkuXiKhyfPSu8tUhnVBB1iKXevvnlR4Ww==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 12" + } + }, + "node_modules/kleur": { + "version": "4.1.5", + "resolved": "https://registry.npmjs.org/kleur/-/kleur-4.1.5.tgz", + "integrity": "sha512-o+NO+8WrRiQEE4/7nwRJhN1HWpVmJm511pBHUxPLtp0BUISzlBplORYSmTclCnJvQq2tKu/sgl3xVpkc7ZWuQQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/linkify-it": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/linkify-it/-/linkify-it-6.1.0.tgz", + "integrity": "sha512-wJ/TwpSDTLepCrQoYWYIExIKg5Zchex2Nn5yk2mFnB+6PtdkHtyLx742md9csRjjOnGkKIS/RrbY7l8D6gT9Vw==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/puzrin" + }, + { + "type": "github", + "url": "https://github.com/sponsors/markdown-it" + } + ], + "license": "MIT", + "dependencies": { + "uc.micro": "^3.0.0" + } + }, + "node_modules/markdown-it": { + "version": "15.0.1", + "resolved": "https://registry.npmjs.org/markdown-it/-/markdown-it-15.0.1.tgz", + "integrity": "sha512-9/7gE95FNPkfUWrjJIoHZza2iLmuJlPD0UNMxPi7bxUrbCR525YZY0r+zyfes0dZI5ZZ/uNIXUJca0pJvtw41g==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/puzrin" + }, + { + "type": "github", + "url": "https://github.com/sponsors/markdown-it" + } + ], + "license": "MIT", + "dependencies": { + "argparse": "^3.0.0", + "entities": "^8.0.0", + "linkify-it": "^6.0.0", + "mdurl": "^2.1.0", + "punycode.js": "^2.3.1", + "uc.micro": "^3.0.0" + }, + "bin": { + "markdown-it": "bin/markdown-it.mjs" + } + }, + "node_modules/markdown-it/node_modules/argparse": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/argparse/-/argparse-3.0.2.tgz", + "integrity": "sha512-mFdDM6WqWKraGLsVb+C9CahPnzTXOefAOLq3jYcca2YZ8bEWpr++Tzj+zSaKW9+X9L5uSxcm1AZ3Y6aZJ09OhQ==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/puzrin" + }, + { + "type": "github", + "url": "https://github.com/sponsors/nodeca" + } + ], + "license": "PSF-2.0" + }, + "node_modules/markdownlint": { + "version": "0.41.1", + "resolved": "https://registry.npmjs.org/markdownlint/-/markdownlint-0.41.1.tgz", + "integrity": "sha512-qHKeU2E1bdyNAT077go2FVTNXvYcktN5IHtF6XyeD1l0PClxzSp2tUApAV14ORI8DGX4H9bNKZEzelZp4qn8IA==", + "dev": true, + "license": "MIT", + "dependencies": { + "micromark": "4.0.2", + "micromark-core-commonmark": "2.0.3", + "micromark-extension-directive": "4.0.0", + "micromark-extension-gfm-autolink-literal": "2.1.0", + "micromark-extension-gfm-footnote": "2.1.0", + "micromark-extension-gfm-table": "2.1.1", + "micromark-extension-math": "3.1.0", + "micromark-util-types": "2.0.2", + "string-width": "8.2.1" + }, + "engines": { + "node": ">=22" + }, + "funding": { + "url": "https://github.com/sponsors/DavidAnson" + } + }, + "node_modules/markdownlint-cli2": { + "version": "0.23.3", + "resolved": "https://registry.npmjs.org/markdownlint-cli2/-/markdownlint-cli2-0.23.3.tgz", + "integrity": "sha512-xAr5o/TGpC3v6lE6cKIW4b5eOFRrRX5u7Vtjae9ix3RALv8nNOd94XMkD/1OXXBtpMcJ4uQGbpSo3hv5UqS4uQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "globby": "16.2.4", + "js-yaml": "5.4.1", + "jsonc-parser": "3.3.1", + "jsonpointer": "5.0.1", + "markdown-it": "15.0.1", + "markdownlint": "0.41.1", + "markdownlint-cli2-formatter-default": "0.0.6", + "micromatch": "4.0.8", + "smol-toml": "1.8.0" + }, + "bin": { + "markdownlint-cli2": "markdownlint-cli2-bin.mjs" + }, + "engines": { + "node": ">=22" + }, + "funding": { + "url": "https://github.com/sponsors/DavidAnson" + } + }, + "node_modules/markdownlint-cli2-formatter-default": { + "version": "0.0.6", + "resolved": "https://registry.npmjs.org/markdownlint-cli2-formatter-default/-/markdownlint-cli2-formatter-default-0.0.6.tgz", + "integrity": "sha512-VVDGKsq9sgzu378swJ0fcHfSicUnMxnL8gnLm/Q4J/xsNJ4e5bA6lvAz7PCzIl0/No0lHyaWdqVD2jotxOSFMQ==", + "dev": true, + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/DavidAnson" + }, + "peerDependencies": { + "markdownlint-cli2": ">=0.0.4" + } + }, + "node_modules/math-intrinsics": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz", + "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/mdurl": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/mdurl/-/mdurl-2.1.0.tgz", + "integrity": "sha512-1+HBaOx0zi/dQWht8rNv9MYf9qqpqL/kxI0hXImU6Y547zM6Sni8BQibt7ifgMcYtQg41ao3Ivd6cnSM86inpg==", + "dev": true, + "license": "MIT" + }, + "node_modules/merge2": { + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz", + "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 8" + } + }, + "node_modules/micromark": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/micromark/-/micromark-4.0.2.tgz", + "integrity": "sha512-zpe98Q6kvavpCr1NPVSCMebCKfD7CA2NqZ+rykeNhONIJBpc1tFKt9hucLGwha3jNTNI8lHpctWJWoimVF4PfA==", + "dev": true, + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "@types/debug": "^4.0.0", + "debug": "^4.0.0", + "decode-named-character-reference": "^1.0.0", + "devlop": "^1.0.0", + "micromark-core-commonmark": "^2.0.0", + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-chunked": "^2.0.0", + "micromark-util-combine-extensions": "^2.0.0", + "micromark-util-decode-numeric-character-reference": "^2.0.0", + "micromark-util-encode": "^2.0.0", + "micromark-util-normalize-identifier": "^2.0.0", + "micromark-util-resolve-all": "^2.0.0", + "micromark-util-sanitize-uri": "^2.0.0", + "micromark-util-subtokenize": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-core-commonmark": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/micromark-core-commonmark/-/micromark-core-commonmark-2.0.3.tgz", + "integrity": "sha512-RDBrHEMSxVFLg6xvnXmb1Ayr2WzLAWjeSATAoxwKYJV94TeNavgoIdA0a9ytzDSVzBy2YKFK+emCPOEibLeCrg==", + "dev": true, + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "decode-named-character-reference": "^1.0.0", + "devlop": "^1.0.0", + "micromark-factory-destination": "^2.0.0", + "micromark-factory-label": "^2.0.0", + "micromark-factory-space": "^2.0.0", + "micromark-factory-title": "^2.0.0", + "micromark-factory-whitespace": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-chunked": "^2.0.0", + "micromark-util-classify-character": "^2.0.0", + "micromark-util-html-tag-name": "^2.0.0", + "micromark-util-normalize-identifier": "^2.0.0", + "micromark-util-resolve-all": "^2.0.0", + "micromark-util-subtokenize": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-extension-directive": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/micromark-extension-directive/-/micromark-extension-directive-4.0.0.tgz", + "integrity": "sha512-/C2nqVmXXmiseSSuCdItCMho7ybwwop6RrrRPk0KbOHW21JKoCldC+8rFOaundDoRBUWBnJJcxeA/Kvi34WQXg==", + "dev": true, + "license": "MIT", + "dependencies": { + "devlop": "^1.0.0", + "micromark-factory-space": "^2.0.0", + "micromark-factory-whitespace": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0", + "parse-entities": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-gfm-autolink-literal": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/micromark-extension-gfm-autolink-literal/-/micromark-extension-gfm-autolink-literal-2.1.0.tgz", + "integrity": "sha512-oOg7knzhicgQ3t4QCjCWgTmfNhvQbDDnJeVu9v81r7NltNCVmhPy1fJRX27pISafdjL+SVc4d3l48Gb6pbRypw==", + "dev": true, + "license": "MIT", + "dependencies": { + "micromark-util-character": "^2.0.0", + "micromark-util-sanitize-uri": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-gfm-footnote": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/micromark-extension-gfm-footnote/-/micromark-extension-gfm-footnote-2.1.0.tgz", + "integrity": "sha512-/yPhxI1ntnDNsiHtzLKYnE3vf9JZ6cAisqVDauhp4CEHxlb4uoOTxOCJ+9s51bIB8U1N1FJ1RXOKTIlD5B/gqw==", + "dev": true, + "license": "MIT", + "dependencies": { + "devlop": "^1.0.0", + "micromark-core-commonmark": "^2.0.0", + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-normalize-identifier": "^2.0.0", + "micromark-util-sanitize-uri": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-gfm-table": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/micromark-extension-gfm-table/-/micromark-extension-gfm-table-2.1.1.tgz", + "integrity": "sha512-t2OU/dXXioARrC6yWfJ4hqB7rct14e8f7m0cbI5hUmDyyIlwv5vEtooptH8INkbLzOatzKuVbQmAYcbWoyz6Dg==", + "dev": true, + "license": "MIT", + "dependencies": { + "devlop": "^1.0.0", + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-extension-math": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/micromark-extension-math/-/micromark-extension-math-3.1.0.tgz", + "integrity": "sha512-lvEqd+fHjATVs+2v/8kg9i5Q0AP2k85H0WUOwpIVvUML8BapsMvh1XAogmQjOCsLpoKRCVQqEkQBB3NhVBcsOg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/katex": "^0.16.0", + "devlop": "^1.0.0", + "katex": "^0.16.0", + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/micromark-factory-destination": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-factory-destination/-/micromark-factory-destination-2.0.1.tgz", + "integrity": "sha512-Xe6rDdJlkmbFRExpTOmRj9N3MaWmbAgdpSrBQvCFqhezUn4AHqJHbaEnfbVYYiexVSs//tqOdY/DxhjdCiJnIA==", + "dev": true, + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-factory-label": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-factory-label/-/micromark-factory-label-2.0.1.tgz", + "integrity": "sha512-VFMekyQExqIW7xIChcXn4ok29YE3rnuyveW3wZQWWqF4Nv9Wk5rgJ99KzPvHjkmPXF93FXIbBp6YdW3t71/7Vg==", + "dev": true, + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "devlop": "^1.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-factory-space": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-factory-space/-/micromark-factory-space-2.0.1.tgz", + "integrity": "sha512-zRkxjtBxxLd2Sc0d+fbnEunsTj46SWXgXciZmHq0kDYGnck/ZSGj9/wULTV95uoeYiK5hRXP2mJ98Uo4cq/LQg==", + "dev": true, + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-character": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-factory-title": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-factory-title/-/micromark-factory-title-2.0.1.tgz", + "integrity": "sha512-5bZ+3CjhAd9eChYTHsjy6TGxpOFSKgKKJPJxr293jTbfry2KDoWkhBb6TcPVB4NmzaPhMs1Frm9AZH7OD4Cjzw==", + "dev": true, + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-factory-whitespace": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-factory-whitespace/-/micromark-factory-whitespace-2.0.1.tgz", + "integrity": "sha512-Ob0nuZ3PKt/n0hORHyvoD9uZhr+Za8sFoP+OnMcnWK5lngSzALgQYKMr9RJVOWLqQYuyn6ulqGWSXdwf6F80lQ==", + "dev": true, + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-factory-space": "^2.0.0", + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-character": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/micromark-util-character/-/micromark-util-character-2.1.1.tgz", + "integrity": "sha512-wv8tdUTJ3thSFFFJKtpYKOYiGP2+v96Hvk4Tu8KpCAsTMs6yi+nVmGh1syvSCsaxz45J6Jbw+9DD6g97+NV67Q==", + "dev": true, + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-chunked": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-chunked/-/micromark-util-chunked-2.0.1.tgz", + "integrity": "sha512-QUNFEOPELfmvv+4xiNg2sRYeS/P84pTW0TCgP5zc9FpXetHY0ab7SxKyAQCNCc1eK0459uoLI1y5oO5Vc1dbhA==", + "dev": true, + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-symbol": "^2.0.0" + } + }, + "node_modules/micromark-util-classify-character": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-classify-character/-/micromark-util-classify-character-2.0.1.tgz", + "integrity": "sha512-K0kHzM6afW/MbeWYWLjoHQv1sgg2Q9EccHEDzSkxiP/EaagNzCm7T/WMKZ3rjMbvIpvBiZgwR3dKMygtA4mG1Q==", + "dev": true, + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-character": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-combine-extensions": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-combine-extensions/-/micromark-util-combine-extensions-2.0.1.tgz", + "integrity": "sha512-OnAnH8Ujmy59JcyZw8JSbK9cGpdVY44NKgSM7E9Eh7DiLS2E9RNQf0dONaGDzEG9yjEl5hcqeIsj4hfRkLH/Bg==", + "dev": true, + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-chunked": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-decode-numeric-character-reference": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/micromark-util-decode-numeric-character-reference/-/micromark-util-decode-numeric-character-reference-2.0.2.tgz", + "integrity": "sha512-ccUbYk6CwVdkmCQMyr64dXz42EfHGkPQlBj5p7YVGzq8I7CtjXZJrubAYezf7Rp+bjPseiROqe7G6foFd+lEuw==", + "dev": true, + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-symbol": "^2.0.0" + } + }, + "node_modules/micromark-util-encode": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-encode/-/micromark-util-encode-2.0.1.tgz", + "integrity": "sha512-c3cVx2y4KqUnwopcO9b/SCdo2O67LwJJ/UyqGfbigahfegL9myoEFoDYZgkT7f36T0bLrM9hZTAaAyH+PCAXjw==", + "dev": true, + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT" + }, + "node_modules/micromark-util-html-tag-name": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-html-tag-name/-/micromark-util-html-tag-name-2.0.1.tgz", + "integrity": "sha512-2cNEiYDhCWKI+Gs9T0Tiysk136SnR13hhO8yW6BGNyhOC4qYFnwF1nKfD3HFAIXA5c45RrIG1ub11GiXeYd1xA==", + "dev": true, + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT" + }, + "node_modules/micromark-util-normalize-identifier": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-normalize-identifier/-/micromark-util-normalize-identifier-2.0.1.tgz", + "integrity": "sha512-sxPqmo70LyARJs0w2UclACPUUEqltCkJ6PhKdMIDuJ3gSf/Q+/GIe3WKl0Ijb/GyH9lOpUkRAO2wp0GVkLvS9Q==", + "dev": true, + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-symbol": "^2.0.0" + } + }, + "node_modules/micromark-util-resolve-all": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-resolve-all/-/micromark-util-resolve-all-2.0.1.tgz", + "integrity": "sha512-VdQyxFWFT2/FGJgwQnJYbe1jjQoNTS4RjglmSjTUlpUMa95Htx9NHeYW4rGDJzbjvCsl9eLjMQwGeElsqmzcHg==", + "dev": true, + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-sanitize-uri": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-sanitize-uri/-/micromark-util-sanitize-uri-2.0.1.tgz", + "integrity": "sha512-9N9IomZ/YuGGZZmQec1MbgxtlgougxTodVwDzzEouPKo3qFWvymFHWcnDi2vzV1ff6kas9ucW+o3yzJK9YB1AQ==", + "dev": true, + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-character": "^2.0.0", + "micromark-util-encode": "^2.0.0", + "micromark-util-symbol": "^2.0.0" + } + }, + "node_modules/micromark-util-subtokenize": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/micromark-util-subtokenize/-/micromark-util-subtokenize-2.1.0.tgz", + "integrity": "sha512-XQLu552iSctvnEcgXw6+Sx75GflAPNED1qx7eBJ+wydBb2KCbRZe+NwvIEEMM83uml1+2WSXpBAcp9IUCgCYWA==", + "dev": true, + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "devlop": "^1.0.0", + "micromark-util-chunked": "^2.0.0", + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-symbol": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-symbol/-/micromark-util-symbol-2.0.1.tgz", + "integrity": "sha512-vs5t8Apaud9N28kgCrRUdEed4UJ+wWNvicHLPxCa9ENlYuAY31M0ETy5y1vA33YoNPDFTghEbnh6efaE8h4x0Q==", + "dev": true, + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT" + }, + "node_modules/micromark-util-types": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/micromark-util-types/-/micromark-util-types-2.0.2.tgz", + "integrity": "sha512-Yw0ECSpJoViF1qTU4DC6NwtC4aWGt1EkzaQB8KPPyCRR8z9TWeV0HbEFGTO+ZY1wB22zmxnJqhPyTpOVCpeHTA==", + "dev": true, + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT" + }, + "node_modules/micromatch": { + "version": "4.0.8", + "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz", + "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==", + "dev": true, + "license": "MIT", + "dependencies": { + "braces": "^3.0.3", + "picomatch": "^2.3.1" + }, + "engines": { + "node": ">=8.6" + } + }, + "node_modules/micromatch/node_modules/picomatch": { + "version": "2.3.2", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz", + "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8.6" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/mime": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/mime/-/mime-1.6.0.tgz", + "integrity": "sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg==", + "dev": true, + "license": "MIT", + "bin": { + "mime": "cli.js" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/minimist": { + "version": "1.2.8", + "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz", + "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==", + "dev": true, + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "dev": true, + "license": "MIT" + }, + "node_modules/object-inspect": { + "version": "1.13.4", + "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz", + "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/opener": { + "version": "1.5.2", + "resolved": "https://registry.npmjs.org/opener/-/opener-1.5.2.tgz", + "integrity": "sha512-ur5UIdyw5Y7yEj9wLzhqXiy6GZ3Mwx0yGI+5sMn2r0N0v3cKJvUmFH5yPP+WXh9e0xfyzyJX95D8l088DNFj7A==", + "dev": true, + "license": "(WTFPL OR MIT)", + "bin": { + "opener": "bin/opener-bin.js" + } + }, + "node_modules/parse-entities": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/parse-entities/-/parse-entities-4.0.2.tgz", + "integrity": "sha512-GG2AQYWoLgL877gQIKeRPGO1xF9+eG1ujIb5soS5gPvLQ1y2o8FL90w2QWNdf9I361Mpp7726c+lj3U0qK1uGw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/unist": "^2.0.0", + "character-entities-legacy": "^3.0.0", + "character-reference-invalid": "^2.0.0", + "decode-named-character-reference": "^1.0.0", + "is-alphanumerical": "^2.0.0", + "is-decimal": "^2.0.0", + "is-hexadecimal": "^2.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/picomatch": { + "version": "4.0.7", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.7.tgz", + "integrity": "sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/playwright": { + "version": "1.63.0", + "resolved": "https://registry.npmjs.org/playwright/-/playwright-1.63.0.tgz", + "integrity": "sha512-+7ziBLidS4NaNCdt57SUDT+wYmmd5fmiQejUic/kb+YsYSCPyOOE9sebzMjNmQrsnNpDJqd4WHvV/8lfKfUDUg==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "playwright-core": "1.63.0" + }, + "bin": { + "playwright": "cli.js" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/playwright-core": { + "version": "1.63.0", + "resolved": "https://registry.npmjs.org/playwright-core/-/playwright-core-1.63.0.tgz", + "integrity": "sha512-rYCsBF/M5HjUch52bbtVONEFjv6Xu8sm8h72dNlR5bzIE1fvC/bxgspzkjSfU+MweEMmPM8KJebG6nnyxo5mCg==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "playwright-core": "cli.js" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/portfinder": { + "version": "1.0.38", + "resolved": "https://registry.npmjs.org/portfinder/-/portfinder-1.0.38.tgz", + "integrity": "sha512-rEwq/ZHlJIKw++XtLAO8PPuOQA/zaPJOZJ37BVuN97nLpMJeuDVLVGRwbFoBgLudgdTMP2hdRJP++H+8QOA3vg==", + "dev": true, + "license": "MIT", + "dependencies": { + "async": "^3.2.6", + "debug": "^4.3.6" + }, + "engines": { + "node": ">= 10.12" + } + }, + "node_modules/prompts": { + "version": "2.4.2", + "resolved": "https://registry.npmjs.org/prompts/-/prompts-2.4.2.tgz", + "integrity": "sha512-NxNv/kLguCA7p3jE8oL2aEBsrJWgAakBpgmgK6lpPWV+WuOmY6r2/zbAVnP+T8bQlA0nzHXSJSJW0Hq7ylaD2Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "kleur": "^3.0.3", + "sisteransi": "^1.0.5" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/prompts/node_modules/kleur": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/kleur/-/kleur-3.0.3.tgz", + "integrity": "sha512-eTIzlVOSUR+JxdDFepEYcBMtZ9Qqdef+rnzWdRZuMbOywu5tO2w2N7rqjoANZ5k9vywhL6Br1VRjUIgTQx4E8w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/punycode.js": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/punycode.js/-/punycode.js-2.3.1.tgz", + "integrity": "sha512-uxFIHU0YlHYhDQtV4R9J6a52SLx28BCjT+4ieh7IGbgwVJWO+km431c4yRlREUAsAmt/uMjQUyQHNEPf0M39CA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/qs": { + "version": "6.15.3", + "resolved": "https://registry.npmjs.org/qs/-/qs-6.15.3.tgz", + "integrity": "sha512-O9gl3zCl5h5blw1KGUzQKhA5oUXSl8rwUIM5o0S3nCXMliSvy5Dzx7/DJcI+SwgICv+IneSZwhBh1oSyEHA71A==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "es-define-property": "^1.0.1", + "side-channel": "^1.1.1" + }, + "engines": { + "node": ">=0.6" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/queue-microtask": { + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz", + "integrity": "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, + "node_modules/require-from-string": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz", + "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/requires-port": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/requires-port/-/requires-port-1.0.0.tgz", + "integrity": "sha512-KigOCHcocU3XODJxsu8i/j8T9tzT4adHiecwORRQ0ZZFcp7ahwXuRU1m+yuO90C5ZUyGeGfocHDI14M3L3yDAQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/resolve-from": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-5.0.0.tgz", + "integrity": "sha512-qYg9KP24dD5qka9J47d0aVky0N+b4fTU89LN9iDnjB5waksiC49rvMB0PrUJQGoTmH50XPiqOvAjDfaijGxYZw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/reusify": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.1.0.tgz", + "integrity": "sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==", + "dev": true, + "license": "MIT", + "engines": { + "iojs": ">=1.0.0", + "node": ">=0.10.0" + } + }, + "node_modules/run-parallel": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/run-parallel/-/run-parallel-1.2.0.tgz", + "integrity": "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "dependencies": { + "queue-microtask": "^1.2.2" + } + }, + "node_modules/safe-buffer": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz", + "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==", + "dev": true, + "license": "MIT" + }, + "node_modules/safer-buffer": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz", + "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==", + "dev": true, + "license": "MIT" + }, + "node_modules/secure-compare": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/secure-compare/-/secure-compare-3.0.1.tgz", + "integrity": "sha512-AckIIV90rPDcBcglUwXPF3kg0P0qmPsPXAj6BBEENQE1p5yA1xfmDJzfi1Tappj37Pv2mVbKpL3Z1T+Nn7k1Qw==", + "dev": true, + "license": "MIT" + }, + "node_modules/semver": { + "version": "7.8.5", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.5.tgz", + "integrity": "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/side-channel": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.1.tgz", + "integrity": "sha512-6x6dK6zJdpTzF4sQeNYxwtvBzf6Eg4GtlesS94HOvTudUeyK2WXAaIfmDgsyslYrRBeFIlsi54AYsFGUuhmvrQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "object-inspect": "^1.13.4", + "side-channel-list": "^1.0.1", + "side-channel-map": "^1.0.1", + "side-channel-weakmap": "^1.0.2" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-list": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.1.tgz", + "integrity": "sha512-mjn/0bi/oUURjc5Xl7IaWi/OJJJumuoJFQJfDDyO46+hBWsfaVM65TBHq2eoZBhzl9EchxOijpkbRC8SVBQU0w==", + "dev": true, + "license": "MIT", + "dependencies": { + "es-errors": "^1.3.0", + "object-inspect": "^1.13.4" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-map": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz", + "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.5", + "object-inspect": "^1.13.3" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/side-channel-weakmap": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz", + "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==", + "dev": true, + "license": "MIT", + "dependencies": { + "call-bound": "^1.0.2", + "es-errors": "^1.3.0", + "get-intrinsic": "^1.2.5", + "object-inspect": "^1.13.3", + "side-channel-map": "^1.0.1" + }, + "engines": { + "node": ">= 0.4" + }, + "funding": { + "url": "https://github.com/sponsors/ljharb" + } + }, + "node_modules/sisteransi": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/sisteransi/-/sisteransi-1.0.5.tgz", + "integrity": "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==", + "dev": true, + "license": "MIT" + }, + "node_modules/slash": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/slash/-/slash-5.1.0.tgz", + "integrity": "sha512-ZA6oR3T/pEyuqwMgAKT0/hAv8oAXckzbkmR0UkUosQ+Mc4RxGoJkRmwHgHufaenlyAgE1Mxgpdcrf75y6XcnDg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=14.16" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/smol-toml": { + "version": "1.8.0", + "resolved": "https://registry.npmjs.org/smol-toml/-/smol-toml-1.8.0.tgz", + "integrity": "sha512-kCZr2V3ch9i00x8zXRhjUNVcjG9ijES5dDudkXvUVCT5QlJNQWElSJdZqyPemffHoLNUYwOcou0Fy+ojN0uHSQ==", + "dev": true, + "license": "BSD-3-Clause", + "engines": { + "node": ">= 18" + }, + "funding": { + "url": "https://github.com/sponsors/cyyynthia" + } + }, + "node_modules/string-width": { + "version": "8.2.1", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-8.2.1.tgz", + "integrity": "sha512-IIaP0g3iy9Cyy18w3M9YcaDudujEAVHKt3a3QJg1+sr/oX96TbaGUubG0hJyCjCBThFH+tFpcIyoUHUn1ogaLA==", + "dev": true, + "license": "MIT", + "dependencies": { + "get-east-asian-width": "^1.5.0", + "strip-ansi": "^7.1.2" + }, + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/strip-ansi": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.2.0.tgz", + "integrity": "sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^6.2.2" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/strip-ansi?sponsor=1" + } + }, + "node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "dev": true, + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/tinyglobby": { + "version": "0.2.17", + "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.17.tgz", + "integrity": "sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==", + "dev": true, + "license": "MIT", + "dependencies": { + "fdir": "^6.5.0", + "picomatch": "^4.0.4" + }, + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/SuperchupuDev" + } + }, + "node_modules/to-regex-range": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz", + "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-number": "^7.0.0" + }, + "engines": { + "node": ">=8.0" + } + }, + "node_modules/uc.micro": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/uc.micro/-/uc.micro-3.0.0.tgz", + "integrity": "sha512-U3PppEkleoTnIfi8BozMx3yju3qc/L6SwqWo2Sw+54PX+PX0q9I+r1Um5HCmqD7n9VDX5/v3vQH/AjA6deDdtw==", + "dev": true, + "license": "MIT" + }, + "node_modules/unicorn-magic": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/unicorn-magic/-/unicorn-magic-0.4.0.tgz", + "integrity": "sha512-wH590V9VNgYH9g3lH9wWjTrUoKsjLF6sGLjhR4sH1LWpLmCOH0Zf7PukhDA8BiS7KHe4oPNkcTHqYkj7SOGUOw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/union": { + "version": "0.5.0", + "resolved": "https://registry.npmjs.org/union/-/union-0.5.0.tgz", + "integrity": "sha512-N6uOhuW6zO95P3Mel2I2zMsbsanvvtgn6jVqJv4vbVcz/JN0OkL9suomjQGmWtxJQXOCqUJvquc1sMeNz/IwlA==", + "dev": true, + "dependencies": { + "qs": "^6.4.0" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/url-join": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/url-join/-/url-join-4.0.1.tgz", + "integrity": "sha512-jk1+QP6ZJqyOiuEI9AEWQfju/nB2Pw466kbA0LEZljHwKeMgd9WrAEgEGxjPDD2+TNbbb37rTyhEfrCXfuKXnA==", + "dev": true, + "license": "MIT" + }, + "node_modules/vscode-languageserver-textdocument": { + "version": "1.0.15", + "resolved": "https://registry.npmjs.org/vscode-languageserver-textdocument/-/vscode-languageserver-textdocument-1.0.15.tgz", + "integrity": "sha512-Gsfr9S8LU3S6885cS+NaleasJ0n3V5y/SOTqHCifQiXWFw3G9w9/YItDfwHrlCz+dSZWWZ8ilYVMcJe7Sz7Sxw==", + "dev": true, + "license": "MIT" + }, + "node_modules/vscode-uri": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/vscode-uri/-/vscode-uri-3.2.0.tgz", + "integrity": "sha512-m2gXo3bn0G1kT9InzMf07fTbqMbGtyckj3bH5ktLO+1Ssv+yiATZ4dhwaQv9UZWxJh6E9IFGnQyjgWVDWVBDrg==", + "dev": true, + "license": "MIT" + }, + "node_modules/whatwg-encoding": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/whatwg-encoding/-/whatwg-encoding-2.0.0.tgz", + "integrity": "sha512-p41ogyeMUrw3jWclHWTQg1k05DSVXPLcVxRTYsXUk+ZooOCZLcoYgPZ/HL/D/N+uQPOtcp1me1WhBEaX02mhWg==", + "deprecated": "Use @exodus/bytes instead for a more spec-conformant and faster implementation", + "dev": true, + "license": "MIT", + "dependencies": { + "iconv-lite": "0.6.3" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/xdg-basedir": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/xdg-basedir/-/xdg-basedir-5.1.0.tgz", + "integrity": "sha512-GCPAHLvrIH13+c0SuacwvRYj2SxJXQ4kaVTT5xgL3kPrz56XxkF21IGhjSE1+W0aw7gpBWRGXLCPnPby6lSpmQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/yaml": { + "version": "2.9.0", + "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.9.0.tgz", + "integrity": "sha512-2AvhNX3mb8zd6Zy7INTtSpl1F15HW6Wnqj0srWlkKLcpYl/gMIMJiyuGq2KeI2YFxUPjdlB+3Lc10seMLtL4cA==", + "dev": true, + "license": "ISC", + "bin": { + "yaml": "bin.mjs" + }, + "engines": { + "node": ">= 14.6" + }, + "funding": { + "url": "https://github.com/sponsors/eemeli" + } + } + } +} diff --git a/package.json b/package.json new file mode 100644 index 0000000..c2b75c2 --- /dev/null +++ b/package.json @@ -0,0 +1,35 @@ +{ + "name": "rup-flow-docs", + "version": "0.1.0", + "private": true, + "description": "Development and verification tools for the rup-flow documentation site", + "license": "MIT", + "engines": { + "node": ">=24.8.0" + }, + "scripts": { + "lint:markdown": "markdownlint-cli2 \"**/*.md\" \"#node_modules\" \"#.venv\" \"#site\"", + "lint:spelling": "cspell --no-progress --show-suggestions \"**/*.{md,yml,yaml,json,toml,mjs,css,puml,iuml}\"", + "render:diagrams": "node scripts/render-diagrams.mjs", + "validate:diagrams": "node scripts/render-diagrams.mjs --check", + "validate:secrets": "node scripts/scan-secrets.mjs", + "build": "node scripts/build.mjs", + "validate:html": "html-validate \"site/**/*.html\"", + "validate:links": "node scripts/validate-links.mjs", + "validate:privacy": "node scripts/validate-privacy.mjs", + "validate:a11y": "node scripts/validate-a11y.mjs", + "test:release": "node --test test/*.test.mjs", + "verify": "node scripts/verify.mjs" + }, + "devDependencies": { + "@axe-core/playwright": "4.13.0", + "cspell": "10.3.5", + "html-validate": "11.16.1", + "http-server": "14.1.1", + "markdownlint-cli2": "0.23.3", + "playwright": "1.63.0" + }, + "rupFlow": { + "version": "0.4.0" + } +} diff --git a/pyproject.toml b/pyproject.toml new file mode 100644 index 0000000..2d36f4f --- /dev/null +++ b/pyproject.toml @@ -0,0 +1,14 @@ +[project] +name = "rup-flow-docs" +version = "0.1.0" +description = "Professional, versioned documentation for rup-flow" +requires-python = ">=3.13,<3.14" +dependencies = [ + "mike==2.2.0", + "mkdocs-material==9.7.7", +] + +[tool.pip-tools] +generate-hashes = true +strip-extras = true + diff --git a/requirements.lock b/requirements.lock new file mode 100644 index 0000000..07fe83f --- /dev/null +++ b/requirements.lock @@ -0,0 +1,512 @@ +# This file was autogenerated by uv via the following command: +# uv pip compile pyproject.toml --generate-hashes --output-file requirements.lock --python-version 3.13 +babel==2.18.0 \ + --hash=sha256:b80b99a14bd085fcacfa15c9165f651fbb3406e66cc603abf11c5750937c992d \ + --hash=sha256:e2b422b277c2b9a9630c1d7903c2a00d0830c409c59ac8cae9081c92f1aeba35 + # via mkdocs-material +backrefs==8.0 \ + --hash=sha256:4a627b817fd2dce43b79ab48da63613340509381cd8ce0897078a0bce79a2ab8 \ + --hash=sha256:601ce68ca12385dbda06ce264406b4c4210cf5b79fd0fd627592365c92f29a88 \ + --hash=sha256:87f0fae8c5f207fe9f4b2887efc71d42f4900ac78faa1af08d675ef303692dc5 \ + --hash=sha256:9ec96efa080938be92323e8e730e57718c9c88eb15ad70bbef4e1766df591408 \ + --hash=sha256:b556cd7d36c3a3a2f256b89590b176b8eddfb73bcfaee3a3ddd84ea66d21ce50 \ + --hash=sha256:f0c35cf0102ba6b6070c12a492be3c1c1d3f5839529784b9a9565d6d04569a01 + # via mkdocs-material +certifi==2026.7.22 \ + --hash=sha256:62f22742b58a1a33014a2b6b706588a8d7e2a88ae7bd1a6ebe8c992928483775 \ + --hash=sha256:741e2c3b351ddf169a738da9f2c048608ff7f2c5cc02f1ebc6b118bb090d5d55 + # via requests +charset-normalizer==3.5.0 \ + --hash=sha256:054420b5db984971d886e5e4e2c37c760ae6682aedbd066687ff0949d9ed5f08 \ + --hash=sha256:06f4fb62a9139bef056b8b2da6773c94c2f259f90e4b8e53b166f3d0372d7cf6 \ + --hash=sha256:076cf9d3f3c7e410295c09d96355cf3b1bcae74990034d80e4371e20fe1ba4c6 \ + --hash=sha256:07f6f42b5a6325df35b458004fb5f9f29bf502d89287a33c7cdef3590e31de0f \ + --hash=sha256:0b2e44e6d42d1a4ff78ccc219a93c5449105d10b16198d1aea581080df8073f9 \ + --hash=sha256:0b373bab0b867b68b8eb249da9478cab9181a42993437cd2f5dba5fb0b4fbd1b \ + --hash=sha256:0c8953d9d1617794cfc40d81179571c9ba3805dd029623a15c93f1fb70e60a74 \ + --hash=sha256:0cce46dd29d73e135e8087b96eb62a4aca6d69391b7f97808c6588ebed3178f3 \ + --hash=sha256:0dfe83c1b4d00abbf433998117a14f56a5c2bc68226c0d331709eed0d1ce539b \ + --hash=sha256:0f211c21aa316cb6e2662e54a1194633a79d98a50a876addacfce7ba5b34b09f \ + --hash=sha256:0f76dc0a47f94cb9b69d86f01e477f4b0371ca70208b9ccea7e063c41eed9046 \ + --hash=sha256:125ee619611019471b177c70bc3e9d4cda9fad7e01d93523501d3b188df0193a \ + --hash=sha256:1328cc57dd4372be1265f68232cee890e087416e3e6e93e6ffb32c2bad4d36a4 \ + --hash=sha256:143792a43e06dc3b27fc891948406e251502dc19ff9216cd80182b79131be5c5 \ + --hash=sha256:14f6904a3cf870abf044df3a8c4924ac6c8ef77e9896586fd37e73ae96cff2af \ + --hash=sha256:168a0cb536b5123a77bc42ecf5e0bf6f923d0d9ae43c42a14eb0677c19ac6c19 \ + --hash=sha256:17a0fd0e23961c2c017372e37aabc7ca8fceb9e10ad898977dfb40ad3927baae \ + --hash=sha256:17db18db9a1374d5b9d9a3252f980b4243b0b4efd1df03fac78bb587f6ce98cd \ + --hash=sha256:196e270c4e80827b5072eed7d6aa661d133afada94fe366669f9609e718d305e \ + --hash=sha256:19e52bda45086df8a4be4bb5910af6f5d9d3b538c78712c8ae09ef10b85bf458 \ + --hash=sha256:1a573e1e428f93908e79e04b349717f400e720f2f82285f0aaaf3ee0ff7f4c79 \ + --hash=sha256:1c010dd86d3f4c4433c9634d33ce8147393b270dfa54f217f965540b8ae8e075 \ + --hash=sha256:1cdfed4d7a59333c8220c67dd3be4e7a6c887b67453a64394022dcc919570add \ + --hash=sha256:1d366548d2ee28a8cfdcc4296363978cc644a728333be9824d2de4652e83df0a \ + --hash=sha256:1f56ce84b317ef2a59d7d3461891c7597c79247d2192bb8114c68a1a1debfcc0 \ + --hash=sha256:1f99a8c3a1da5d955edbad18208b3d627bdd54c48a6e739fa877bdca98c686d6 \ + --hash=sha256:2080aa129a28267984cdc902898993d788c995c384e285d0d19199f56760d52e \ + --hash=sha256:22a1889f1c9b752c63c36758a0c2145458e3cadb20fced7a0790002e9dd12b26 \ + --hash=sha256:2401f7671242e921e604f609d429f6b282ea4ca787a6ffd22ed7372011ddb9d1 \ + --hash=sha256:2403b489c103e9a18c835863fc6dd54361355c8291d4cafdb37492b683440b9b \ + --hash=sha256:2df26d4134948616be0ece05d0b24d621d3990f37147b5883c52052b613ef1f5 \ + --hash=sha256:301bfc4877c4f4f62b344235ecc58d06c901683801636eef819f88769c315ba2 \ + --hash=sha256:30ae26a1adcd943690dcbbc47f28be762bae9e08ad7442b78c86b1c0dd5a626c \ + --hash=sha256:3288a560dc3114d5d2ebe309b1ef43f8af355eafe25856832415c2a8196c9db3 \ + --hash=sha256:32e6d56dd825205f81e5c45bcebb4df6a11fb2bbf4969a01ef156d6ced90c224 \ + --hash=sha256:3418edd0ecb72a0a3861cf72f31be0ad9b7fe338ce2b58fb5cc80b9aeb792700 \ + --hash=sha256:3587d94b5c9f05c2dc4c3f3d47aba6375ff141a21adae3051d8d4d53e8a937c0 \ + --hash=sha256:3684ebbdffd51329ac44245d1d227d90b965797aa1a8abd026568a1f6ae88811 \ + --hash=sha256:368eb2fc9482158b3a3386e8f01fa61f479c968e9a19ceab8f0188b86b312991 \ + --hash=sha256:38a395079f229a631dece74e24c69c1f612536dd51f345a7d6a98abe2d3e047a \ + --hash=sha256:3b08ebf9488c7ff5eff038e48e6ea938178dfd9dcc8598b5ca941e4ae27b20be \ + --hash=sha256:3bfbe543d957213fc9a3db4979a8e171b7aa7504c1d737029defdb03a6095a38 \ + --hash=sha256:3cfdab178a4add5483e26a9bb1c16d8018ccf39b4be7a3aea6c3979e6828f2ee \ + --hash=sha256:3d00e18e7bbf47e332ab63903d18bae31efc701b1d8cca0382b97784a621fc44 \ + --hash=sha256:401ea6e7af9e7852ed818f64714b579c1935482049670847ca3bd7ba45dc63fb \ + --hash=sha256:420b19411959eec115063229536788e6b32d0a7fa907d6b940317919120d702d \ + --hash=sha256:4253da1b4456b633651a8d59eb1dc7a8a8fa38241014dd7c217b353e547ae394 \ + --hash=sha256:4346a693c08b1d0cfc0e3325bfb0ecd4322fb1a6904d68cf416f8da5e981b234 \ + --hash=sha256:478650a70a750d75d5add401606c77f77069c32e4ba2c9131dc6cee566962ca0 \ + --hash=sha256:48920bf6fe83eb2226756ac623fa54940487154eb18f80889d5735cf234965c0 \ + --hash=sha256:49bd5feb59b0bf3cbf6ebcf4352e371c95b9da9bacd4449f8b64d0ad2c10a26e \ + --hash=sha256:4c440122e1ea68b1f8b44a631ebf49c39180f6869b1da22d76e8a724208ec6e9 \ + --hash=sha256:4ebebb410bc517e1d284c52a123e82704b21e4e7e26a21ebecf7439d0647b8a3 \ + --hash=sha256:527e28a5e751d9e11369b9c5f9ab35c748eb9c109101920c7deb40d6eadf8d03 \ + --hash=sha256:54c963ce6404e52255b737e8a06d356fc762d59096ae566203a67cf2b7d050f2 \ + --hash=sha256:562d24ca7797c1af8852994950c2e623a907b201fc4b0ed29e92af173d3828ca \ + --hash=sha256:5780a29823e1d2bec69b7a104ead4195a43f3e97782efaedbf1f79a0157af715 \ + --hash=sha256:58ca5dc0a0ef99f2801ec0574214c978e9574055bc783830bbb6e7433218609f \ + --hash=sha256:5a4ee37248dfac25107c758bda99d545ce73e60b44d2dd39e4a2bb9f2831e9f5 \ + --hash=sha256:5a54587f93f2e289f8faf25b35c997d4cc75cf677485ac6f50c985715989f99c \ + --hash=sha256:5b81980668800dd1c69faad8aea6e85a8cee0e13bcd3bba7671695ff16260293 \ + --hash=sha256:5c23fa4f6eccdd601949cb00f3988c01d64e671d8faba356397971077022e144 \ + --hash=sha256:5e68229977b2dea28e7061c0c0630a23f2f9f6e9c6fb38d77d3d6dbfe3768b74 \ + --hash=sha256:5f51a19dc52197a20218b05ec5336d0c6b3b09935f838724722032c8d45dc91a \ + --hash=sha256:606a86c1c3196f3738de39a67a7490bbd61cb31c0e0436070bd0c6a48170b38e \ + --hash=sha256:6083d10a846218502d664375b9448508d9fa580bd834567423156c6abfbe899d \ + --hash=sha256:608553f476fca509537e804c4a71f5eb166ce63b75141f89c2c686ce1aa36956 \ + --hash=sha256:63ea0cc840c66670183578c2630d138c0e944aeadfc33f25173ee240f5db780d \ + --hash=sha256:6753de11eef42f1c321b26d682957d92c7f7bbce6530f34bbe0f9291dd37cc6f \ + --hash=sha256:68b7e84ae8239a94f8d2c8f3f3a3a81bcde54805ec8f42a34de927d155688ec6 \ + --hash=sha256:69d647cf158eb6bc9c99503292abed1f2079a2de5859f06a403f8aee6417475d \ + --hash=sha256:6abb1f356fb865baeb6ebc3fadd843e9a96fbf49b9adcca55037f3cceccb7438 \ + --hash=sha256:6c06875a1d4a7537bef70f659b55c6b55b9a47ec3ba8f2db610350c2d9915e6e \ + --hash=sha256:6c57af4084c10cb3286688d65e4c654190ff5edcbc2411d08cdca0a8a44c59a1 \ + --hash=sha256:6c95450fce59f00c6d08eff6572ec2e736e5054c9450253afd5748f8416f2eb9 \ + --hash=sha256:6da562a20a49673fe365b05750e98d03bb2c5f8b8d03562b014c1abb3df739f1 \ + --hash=sha256:6e44bc2780516b3df986d6fe33103c7080cd9dcd5576fe3cb4b0f64309c8f22b \ + --hash=sha256:70ff1c16eb0eb5ee6bb12739292347f981a5ba764cc4df1bc2e69b0405d4ac3b \ + --hash=sha256:72982d9958a42f8132bf2d6b90214ed66477295ef1188731f98ae3511c6eeb5a \ + --hash=sha256:74892fe9f33d204860e782e0a2030bb39f9f0af1e7a24f7d5a5b632df311f655 \ + --hash=sha256:75e243abbb528c1a774390ed71e3f868a9f37b1373442e4bbadd401cfc505ff4 \ + --hash=sha256:7cdded069549b5eae3d5d9bb6c2e5bb4fe83f9b81863e2a193cd747bf197aebb \ + --hash=sha256:7faa47b56070b3dd6f4898ed28528843ab130d53266cb9948d9b1f3bb1a5c5e8 \ + --hash=sha256:7ffc43fe52618fcd7abc6ee0b46aea527db10da73305fcc6aaf9710ac7a33ec7 \ + --hash=sha256:815f143a91983ba3041bba066e492ae3c42de523fb1c699685a1abf3313b7d1b \ + --hash=sha256:826a295a039178479a325be1ae60eded1f0b10f7dda749df59e2440de8f61d64 \ + --hash=sha256:82cc5835997ec78afe293a192e385099355770a7db94b2fb1239d36b32796f1c \ + --hash=sha256:830c04a49998b5ed58c8b642c65b7b26419397f52392a64121ba9fd0e95e7f9f \ + --hash=sha256:83b62410bd36bb1178a7d563e2ee0cf21eb1c980c912ab99c2c78f06227f1731 \ + --hash=sha256:84b736e3b391601bc47b86da381c749c0f894e9191aaca9f31f30c2632206df3 \ + --hash=sha256:85f9e0e2724bbddf05de65e5fb03b73eb23e985b7df4259c1d19feb302eb8dc2 \ + --hash=sha256:8b3e9e29b8b07cc461b9ce7768db7693a93979d0dadf22046f6f3555ded2f516 \ + --hash=sha256:8b8788f114845c01f2b520e0b91ea58d143276cfc0483aa943e815f7b9555c15 \ + --hash=sha256:8cb9b6892b53bd6d11fa4cde3dbee020b1f0b6656be1fbaa1ec0d4324a7839db \ + --hash=sha256:8efc3f1563ed431882dd0dc0411b5f8ace1b1b89074981deaf6bd8af77dbe1bc \ + --hash=sha256:8f006866047c6ec4b627ec144b1e0bbc7427cb31fd7c08d19897d0ac9032af3d \ + --hash=sha256:91f9f7c151e772acebe489eaec96e96a2877202d7dd144e3f96b8676881715a0 \ + --hash=sha256:9491f594859b68052edebd69e05fb045055a713b57a67974e6c1553b4e503c39 \ + --hash=sha256:96720f2aeed3434bc48f4d52fbad64ecc820cfed88915d664780ed9ba09ede78 \ + --hash=sha256:96ae7ab5d8155fde927aa0864fbc8ba3cc4fde6d41ab0c7cea9d6012b4978603 \ + --hash=sha256:98820e1ceb25c6df7a80c4fd8efa59cb121f99bc7c4c1693ad94a2caff5b311d \ + --hash=sha256:993dfcbe75a85a3784abb5084f2c41b915767c90546fcc92803cffa28611baea \ + --hash=sha256:9a1d9b13e5e394e13e3c316f0d910d100b17681ff59797f30da1dba032061296 \ + --hash=sha256:9bb3e0d1345b9c0fe73673ea656375f38a78ec679c2edeae0c24800f04798a85 \ + --hash=sha256:9ce0f885239357379d92fd9a5fddbe20f0e30e0527c29ba69f8e99eeb1304a76 \ + --hash=sha256:9e0213f3f8a2674a6778be299aea1d6dc6dda015aab86f683bca6d78f81f27bb \ + --hash=sha256:9e726478d7a213847860219d74665a6892a643ac93b8f76580f6cf9ed39996b7 \ + --hash=sha256:a17864853f7c518ae7d4b368af98f427f9396805476af40af8698560f09d7d97 \ + --hash=sha256:a284c36b9c6616bf0a8aa4aabba668a0c75ba65ccf40a79868aeaa69ad996897 \ + --hash=sha256:a3ad0e3da22852533858663848608f3f24c0d35e5cde415a4903476f2b4c88ec \ + --hash=sha256:a5613a3a82c974227bde18f03409e30c467f8065cb56d822e3eb83708a5f223d \ + --hash=sha256:a565303d118ea3b94a4b6c076bf568069726be414e43b06d58f7070b076ce11d \ + --hash=sha256:a60773eb5fda796e6e6f76b9c152d270fe59f9788a51a6ff8ba44082d8548ae4 \ + --hash=sha256:a7cb4cd266bd85613367fb85a30cfbf6fe6349919e87e18ca8dba584951bfb8a \ + --hash=sha256:a864bdcacd8bff58bb4845304e031f821a3ec64b2b7259f2d409cd49c9e59ca3 \ + --hash=sha256:ac5a9cc079c67d75f4ddf343276031879eadbb333d1bb231cce297b8d7b9aae8 \ + --hash=sha256:ac68ebfa549cc623e0e9add2937526340c629ccf667b4da85b7ef5f99e70bbd9 \ + --hash=sha256:aff38231e3171c578b2c449a01afa44e9ff40844597a32873da102394f63d28e \ + --hash=sha256:b476cdb63df22da2b91837593380be3ddbe406f36c506c1c91d80e7196b66288 \ + --hash=sha256:b787efadba00f5da6fe89513bfbe3852d52ca3a448fdec165765cb3b44a80248 \ + --hash=sha256:b7eb3eab5c646d3de7dcb14a7c9caebace5249c5767da39e1761cb1576e521a3 \ + --hash=sha256:b8ea208b304587d47931b36481342d20336e0d338ab052f8b4305926482598d6 \ + --hash=sha256:bf1e75dc07a3850b53d1e5f75e04d3ae12afe56284be7821771eaa2466350c73 \ + --hash=sha256:bf91921009025e96ce57a03ced6d14604fc3baf0530351638e9504a55da6fa3b \ + --hash=sha256:c387c6bf91b4774e359a48a179e2872b8e8bf741e4fde06ba8d1665eb9a4760a \ + --hash=sha256:c38d1e9bc2073b0984d2099ea647fd7f6c0d8f83a1e14e0cd32926f16e4c44ce \ + --hash=sha256:c41b067eddcfa5ee6b1169c287605be7fb6b0ea22bba6474c5bb978a668def4f \ + --hash=sha256:c455829625df983f716cbaecbba77f2d1dc2e0e0ed1638c059cece15a279344b \ + --hash=sha256:c54036a518748b6c02e666f6d46c3817561998fb904c3be25b56fb4fe3dc5706 \ + --hash=sha256:c5c6d47a865147e0ae3322ce92e7fb52ba3169d94b447deda56897ea2aa6fac9 \ + --hash=sha256:c5e981a5ac8641381efe6f0029467500661616a530d27bc6eedfe45f840599f8 \ + --hash=sha256:c75191e3c8052045179646cb40e280800a4e0bdfda34d9c949c2f268d44e80e4 \ + --hash=sha256:c825661dfcf843119ab57cdcac0df7a48e168764c66917bc74f9a42ecb096da9 \ + --hash=sha256:c9bde7a960720c8b8e1b5ef7afaa0c9a2f3b55c44abd635b2b29dd066b298e3a \ + --hash=sha256:c9f45186390aee4d1f26f723c615b67df346766c3b16df000d84d6e374f06757 \ + --hash=sha256:d016dc857136c726958102c3b8a3986acdc65ace6fbf12cfdc09cc4bfa2935b2 \ + --hash=sha256:d08952c0f14eb56d9dad72a2e17773b5f709c55b28635822d18c4adf38680833 \ + --hash=sha256:d22a083497d2f7d06a57172c5b60ee66cedcf304fde5226d4dfdc94f6180f5b1 \ + --hash=sha256:d2478bd3b2ead3962a484fb802891be40d10049fb74f83e09cb4463fad023fea \ + --hash=sha256:d54625cbf4e6b60bf0639728cb8b4cb541e340f6d7cafae5806051a40ddf4c45 \ + --hash=sha256:d6100f877d2ed95f0856a3fde25334153add94bf2224c43f45f88e7039262aaa \ + --hash=sha256:d672f329ae504ee240eb39b6effb3318aa8e7e8924c0ce8eee5760b3fad98539 \ + --hash=sha256:d7229a99120c6c2792d96f4857c2648ce5530e93667a2c2388c5ef69a6b84775 \ + --hash=sha256:d74bcf1cdd8ac8267fb216473ce6b112efa07b163536288094541415084d131c \ + --hash=sha256:d788e2ded0c4c47efa4d73cfe59eaf975ee32f425219873d2cb3e3fbaa00f636 \ + --hash=sha256:d867cefea33acad8e33a3eb408cca7889a9cf999bd5433d962089d5a13b6e75f \ + --hash=sha256:d8a9316f4da85e937242642b537c6d55d7e9287dd38e5634732f8233932aff45 \ + --hash=sha256:d90254c8f609338c53ec180fcd4c4f9c16502e238e3fc88ca7fd4c2f38d445b8 \ + --hash=sha256:d9419f44e568f7fafcdc0b3b5c766a2364e705a9b34fb8a56b431e0d1f3f4258 \ + --hash=sha256:d95244906ed69d0f79f190893c65e336c15959003e21449256dc05c001b52ea2 \ + --hash=sha256:dc28949de1bb5f7f30a46f15d74ce7ac5aaa63e03c5de04d68f571c7423af834 \ + --hash=sha256:dc7f6aca0bdac5e6520c8b6769bda69315fe7cb57f69885f115bc8ca02d1d022 \ + --hash=sha256:deb99535e9bf0bea8e274c6413eb939a21be35a3f492678dba4d5b1f4d70f142 \ + --hash=sha256:e31786a947b136329bfdc458c82c06d4ec539b4a4436b7da4df4aafc9902ee80 \ + --hash=sha256:e3b9eaa99a6d8c9ace4cd303915947ef55088d4cd87c6676874f98c5c03aa040 \ + --hash=sha256:e46a37ea7fcf9ae01d71b2e5ece19f1565987f3e308394b829197cbefc061f92 \ + --hash=sha256:e4e8fa586df2208ef040684751345f10f503834a757c9a74ecd19c1a2f9b1ccd \ + --hash=sha256:e54dd1a66fa4bce0ccaf0db9dde336e49b3eec646dc4c1c0991279369d373a14 \ + --hash=sha256:e5f834965c2fe589837bac1002e07e25734ff70381903ccd95b3d649e22bfa40 \ + --hash=sha256:ec6c464cf45867f66a2273e2214d9199a8fbad5cb95ca0fd45f6a2fe1d9d2cf4 \ + --hash=sha256:f044cb1cf44012184715f46584658993b5fee9344d71c4b0c455a17a299730c0 \ + --hash=sha256:f0fde5e5100c735b2274ab898f0742a5dcde492796296cfbe7e0ad6a4cd1a396 \ + --hash=sha256:f1619a3cc174a7e3963dd34348e6fceb6e50db0ddeb0031bd7c73a58286454fa \ + --hash=sha256:f278e131afa96a3622cef9211c406ea2ad1b68eb06f8837cd443684a40e0ae50 \ + --hash=sha256:f2ce3d39fb4a9d674e6639dd5d3146b2e273475d2260f10163228d66fc04433d \ + --hash=sha256:f7496aed56b06325a1ad419c5bf23c6dd042558e874f71dd1b958f3e255f3053 \ + --hash=sha256:f8cd1283a9fe6c2065c807e9d5da81afe5e1e004caef39adc0d8ae86dd883698 \ + --hash=sha256:f9f91d3e8382900f3a68fa0ce94294479de9cd2de6bc0c70acd0f0dfd511836b \ + --hash=sha256:fd68c825548a611158230e2f9222e210ceb2e3391995c0aa5865cbdf3ab4bd49 \ + --hash=sha256:fded2e82ff082e5d8e017e2ddcc1411bd8cb83b8585097fc401ef574f756b888 \ + --hash=sha256:fec352b793cdc183cc9e7e0b6c10fd7bff38ec54ba44cc43599b9b56f7f3db2e \ + --hash=sha256:ffdd7ac514301d0a67f7c23b9f2b431ef909a3c3dd6c3766668d0a6f5900c94e + # via requests +click==8.4.2 \ + --hash=sha256:9a6cea6e60b17ebe0a44c5cc636d94f09bd66142c1cd7d8b4cd731c4917a15f6 \ + --hash=sha256:e6f9f66136c816745b9d65817da91d61d957fb16e02e4dcd0552553c5a197b76 + # via mkdocs +colorama==0.4.6 \ + --hash=sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44 \ + --hash=sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6 + # via + # click + # mkdocs + # mkdocs-material +ghp-import==2.1.0 \ + --hash=sha256:8337dd7b50877f163d4c0289bc1f1c7f127550241988d568c1db512c4324a619 \ + --hash=sha256:9c535c4c61193c2df8871222567d7fd7e5014d835f97dc7b7439069e2413d343 + # via mkdocs +idna==3.18 \ + --hash=sha256:7f952cbe720b688055e3f87de14f5c3e5fdaa8bc3928985c4077ca689de849a2 \ + --hash=sha256:ffb385a7e039654cef1ab9ef32c6fafe283c0c0467bba1d9029738ce4a14a848 + # via requests +jinja2==3.1.6 \ + --hash=sha256:0137fb05990d35f1275a587e9aee6d56da821fc83491a0fb838183be43f66d6d \ + --hash=sha256:85ece4451f492d0c13c5dd7c13a64681a86afae63a5f347908daf103ce6d2f67 + # via + # mike + # mkdocs + # mkdocs-material +markdown==3.10.3 \ + --hash=sha256:3589362618f743188b4d955b874402bc814f4f83f544dc207719f4baa7d9c45f \ + --hash=sha256:fa6c92a00a4a3c98b22728c64a935ae1928250ae65058a6ded814d2cc29a4cea + # via + # mkdocs + # mkdocs-material + # pymdown-extensions +markupsafe==3.0.3 \ + --hash=sha256:0303439a41979d9e74d18ff5e2dd8c43ed6c6001fd40e5bf2e43f7bd9bbc523f \ + --hash=sha256:068f375c472b3e7acbe2d5318dea141359e6900156b5b2ba06a30b169086b91a \ + --hash=sha256:0bf2a864d67e76e5c9a34dc26ec616a66b9888e25e7b9460e1c76d3293bd9dbf \ + --hash=sha256:0db14f5dafddbb6d9208827849fad01f1a2609380add406671a26386cdf15a19 \ + --hash=sha256:0eb9ff8191e8498cca014656ae6b8d61f39da5f95b488805da4bb029cccbfbaf \ + --hash=sha256:0f4b68347f8c5eab4a13419215bdfd7f8c9b19f2b25520968adfad23eb0ce60c \ + --hash=sha256:1085e7fbddd3be5f89cc898938f42c0b3c711fdcb37d75221de2666af647c175 \ + --hash=sha256:116bb52f642a37c115f517494ea5feb03889e04df47eeff5b130b1808ce7c219 \ + --hash=sha256:12c63dfb4a98206f045aa9563db46507995f7ef6d83b2f68eda65c307c6829eb \ + --hash=sha256:133a43e73a802c5562be9bbcd03d090aa5a1fe899db609c29e8c8d815c5f6de6 \ + --hash=sha256:1353ef0c1b138e1907ae78e2f6c63ff67501122006b0f9abad68fda5f4ffc6ab \ + --hash=sha256:15d939a21d546304880945ca1ecb8a039db6b4dc49b2c5a400387cdae6a62e26 \ + --hash=sha256:177b5253b2834fe3678cb4a5f0059808258584c559193998be2601324fdeafb1 \ + --hash=sha256:1872df69a4de6aead3491198eaf13810b565bdbeec3ae2dc8780f14458ec73ce \ + --hash=sha256:1b4b79e8ebf6b55351f0d91fe80f893b4743f104bff22e90697db1590e47a218 \ + --hash=sha256:1b52b4fb9df4eb9ae465f8d0c228a00624de2334f216f178a995ccdcf82c4634 \ + --hash=sha256:1ba88449deb3de88bd40044603fafffb7bc2b055d626a330323a9ed736661695 \ + --hash=sha256:1cc7ea17a6824959616c525620e387f6dd30fec8cb44f649e31712db02123dad \ + --hash=sha256:218551f6df4868a8d527e3062d0fb968682fe92054e89978594c28e642c43a73 \ + --hash=sha256:26a5784ded40c9e318cfc2bdb30fe164bdb8665ded9cd64d500a34fb42067b1c \ + --hash=sha256:2713baf880df847f2bece4230d4d094280f4e67b1e813eec43b4c0e144a34ffe \ + --hash=sha256:2a15a08b17dd94c53a1da0438822d70ebcd13f8c3a95abe3a9ef9f11a94830aa \ + --hash=sha256:2f981d352f04553a7171b8e44369f2af4055f888dfb147d55e42d29e29e74559 \ + --hash=sha256:32001d6a8fc98c8cb5c947787c5d08b0a50663d139f1305bac5885d98d9b40fa \ + --hash=sha256:3524b778fe5cfb3452a09d31e7b5adefeea8c5be1d43c4f810ba09f2ceb29d37 \ + --hash=sha256:3537e01efc9d4dccdf77221fb1cb3b8e1a38d5428920e0657ce299b20324d758 \ + --hash=sha256:35add3b638a5d900e807944a078b51922212fb3dedb01633a8defc4b01a3c85f \ + --hash=sha256:38664109c14ffc9e7437e86b4dceb442b0096dfe3541d7864d9cbe1da4cf36c8 \ + --hash=sha256:3a7e8ae81ae39e62a41ec302f972ba6ae23a5c5396c8e60113e9066ef893da0d \ + --hash=sha256:3b562dd9e9ea93f13d53989d23a7e775fdfd1066c33494ff43f5418bc8c58a5c \ + --hash=sha256:457a69a9577064c05a97c41f4e65148652db078a3a509039e64d3467b9e7ef97 \ + --hash=sha256:4bd4cd07944443f5a265608cc6aab442e4f74dff8088b0dfc8238647b8f6ae9a \ + --hash=sha256:4e885a3d1efa2eadc93c894a21770e4bc67899e3543680313b09f139e149ab19 \ + --hash=sha256:4faffd047e07c38848ce017e8725090413cd80cbc23d86e55c587bf979e579c9 \ + --hash=sha256:509fa21c6deb7a7a273d629cf5ec029bc209d1a51178615ddf718f5918992ab9 \ + --hash=sha256:5678211cb9333a6468fb8d8be0305520aa073f50d17f089b5b4b477ea6e67fdc \ + --hash=sha256:591ae9f2a647529ca990bc681daebdd52c8791ff06c2bfa05b65163e28102ef2 \ + --hash=sha256:5a7d5dc5140555cf21a6fefbdbf8723f06fcd2f63ef108f2854de715e4422cb4 \ + --hash=sha256:69c0b73548bc525c8cb9a251cddf1931d1db4d2258e9599c28c07ef3580ef354 \ + --hash=sha256:6b5420a1d9450023228968e7e6a9ce57f65d148ab56d2313fcd589eee96a7a50 \ + --hash=sha256:722695808f4b6457b320fdc131280796bdceb04ab50fe1795cd540799ebe1698 \ + --hash=sha256:729586769a26dbceff69f7a7dbbf59ab6572b99d94576a5592625d5b411576b9 \ + --hash=sha256:77f0643abe7495da77fb436f50f8dab76dbc6e5fd25d39589a0f1fe6548bfa2b \ + --hash=sha256:795e7751525cae078558e679d646ae45574b47ed6e7771863fcc079a6171a0fc \ + --hash=sha256:7be7b61bb172e1ed687f1754f8e7484f1c8019780f6f6b0786e76bb01c2ae115 \ + --hash=sha256:7c3fb7d25180895632e5d3148dbdc29ea38ccb7fd210aa27acbd1201a1902c6e \ + --hash=sha256:7e68f88e5b8799aa49c85cd116c932a1ac15caaa3f5db09087854d218359e485 \ + --hash=sha256:83891d0e9fb81a825d9a6d61e3f07550ca70a076484292a70fde82c4b807286f \ + --hash=sha256:8485f406a96febb5140bfeca44a73e3ce5116b2501ac54fe953e488fb1d03b12 \ + --hash=sha256:8709b08f4a89aa7586de0aadc8da56180242ee0ada3999749b183aa23df95025 \ + --hash=sha256:8f71bc33915be5186016f675cd83a1e08523649b0e33efdb898db577ef5bb009 \ + --hash=sha256:915c04ba3851909ce68ccc2b8e2cd691618c4dc4c4232fb7982bca3f41fd8c3d \ + --hash=sha256:949b8d66bc381ee8b007cd945914c721d9aba8e27f71959d750a46f7c282b20b \ + --hash=sha256:94c6f0bb423f739146aec64595853541634bde58b2135f27f61c1ffd1cd4d16a \ + --hash=sha256:9a1abfdc021a164803f4d485104931fb8f8c1efd55bc6b748d2f5774e78b62c5 \ + --hash=sha256:9b79b7a16f7fedff2495d684f2b59b0457c3b493778c9eed31111be64d58279f \ + --hash=sha256:a320721ab5a1aba0a233739394eb907f8c8da5c98c9181d1161e77a0c8e36f2d \ + --hash=sha256:a4afe79fb3de0b7097d81da19090f4df4f8d3a2b3adaa8764138aac2e44f3af1 \ + --hash=sha256:ad2cf8aa28b8c020ab2fc8287b0f823d0a7d8630784c31e9ee5edea20f406287 \ + --hash=sha256:b8512a91625c9b3da6f127803b166b629725e68af71f8184ae7e7d54686a56d6 \ + --hash=sha256:bc51efed119bc9cfdf792cdeaa4d67e8f6fcccab66ed4bfdd6bde3e59bfcbb2f \ + --hash=sha256:bdc919ead48f234740ad807933cdf545180bfbe9342c2bb451556db2ed958581 \ + --hash=sha256:bdd37121970bfd8be76c5fb069c7751683bdf373db1ed6c010162b2a130248ed \ + --hash=sha256:be8813b57049a7dc738189df53d69395eba14fb99345e0a5994914a3864c8a4b \ + --hash=sha256:c0c0b3ade1c0b13b936d7970b1d37a57acde9199dc2aecc4c336773e1d86049c \ + --hash=sha256:c47a551199eb8eb2121d4f0f15ae0f923d31350ab9280078d1e5f12b249e0026 \ + --hash=sha256:c4ffb7ebf07cfe8931028e3e4c85f0357459a3f9f9490886198848f4fa002ec8 \ + --hash=sha256:ccfcd093f13f0f0b7fdd0f198b90053bf7b2f02a3927a30e63f3ccc9df56b676 \ + --hash=sha256:d2ee202e79d8ed691ceebae8e0486bd9a2cd4794cec4824e1c99b6f5009502f6 \ + --hash=sha256:d53197da72cc091b024dd97249dfc7794d6a56530370992a5e1a08983ad9230e \ + --hash=sha256:d6dd0be5b5b189d31db7cda48b91d7e0a9795f31430b7f271219ab30f1d3ac9d \ + --hash=sha256:d88b440e37a16e651bda4c7c2b930eb586fd15ca7406cb39e211fcff3bf3017d \ + --hash=sha256:de8a88e63464af587c950061a5e6a67d3632e36df62b986892331d4620a35c01 \ + --hash=sha256:df2449253ef108a379b8b5d6b43f4b1a8e81a061d6537becd5582fba5f9196d7 \ + --hash=sha256:e1c1493fb6e50ab01d20a22826e57520f1284df32f2d8601fdd90b6304601419 \ + --hash=sha256:e1cf1972137e83c5d4c136c43ced9ac51d0e124706ee1c8aa8532c1287fa8795 \ + --hash=sha256:e2103a929dfa2fcaf9bb4e7c091983a49c9ac3b19c9061b6d5427dd7d14d81a1 \ + --hash=sha256:e56b7d45a839a697b5eb268c82a71bd8c7f6c94d6fd50c3d577fa39a9f1409f5 \ + --hash=sha256:e8afc3f2ccfa24215f8cb28dcf43f0113ac3c37c2f0f0806d8c70e4228c5cf4d \ + --hash=sha256:e8fc20152abba6b83724d7ff268c249fa196d8259ff481f3b1476383f8f24e42 \ + --hash=sha256:eaa9599de571d72e2daf60164784109f19978b327a3910d3e9de8c97b5b70cfe \ + --hash=sha256:ec15a59cf5af7be74194f7ab02d0f59a62bdcf1a537677ce67a2537c9b87fcda \ + --hash=sha256:f190daf01f13c72eac4efd5c430a8de82489d9cff23c364c3ea822545032993e \ + --hash=sha256:f34c41761022dd093b4b6896d4810782ffbabe30f2d443ff5f083e0cbbb8c737 \ + --hash=sha256:f3e98bb3798ead92273dc0e5fd0f31ade220f59a266ffd8a4f6065e0a3ce0523 \ + --hash=sha256:f42d0984e947b8adf7dd6dde396e720934d12c506ce84eea8476409563607591 \ + --hash=sha256:f71a396b3bf33ecaa1626c255855702aca4d3d9fea5e051b41ac59a9c1c41edc \ + --hash=sha256:f9e130248f4462aaa8e2552d547f36ddadbeaa573879158d721bbd33dfe4743a \ + --hash=sha256:fed51ac40f757d41b7c48425901843666a6677e3e8eb0abcff09e4ba6e664f50 + # via + # jinja2 + # mkdocs +mergedeep==1.3.4 \ + --hash=sha256:0096d52e9dad9939c3d975a774666af186eda617e6ca84df4c94dec30004f2a8 \ + --hash=sha256:70775750742b25c0d8f36c55aed03d24c3384d17c951b3175d898bd778ef0307 + # via + # mkdocs + # mkdocs-get-deps +mike==2.2.0 \ + --hash=sha256:1e3858e32c0f125aac14432fc7848434358f9ae0962c5c5cde387ad47f6ad25e \ + --hash=sha256:e1f4981c1152eec7c2490a3401142292cc47d686194188416db2648fdfe1d040 + # via octoform-docs (pyproject.toml) +mkdocs==1.6.1 \ + --hash=sha256:7b432f01d928c084353ab39c57282f29f92136665bdd6abf7c1ec8d822ef86f2 \ + --hash=sha256:db91759624d1647f3f34aa0c3f327dd2601beae39a366d6e064c03468d35c20e + # via + # mike + # mkdocs-material +mkdocs-get-deps==0.2.2 \ + --hash=sha256:8ee8d5f316cdbbb2834bc1df6e69c08fe769a83e040060de26d3c19fad3599a1 \ + --hash=sha256:e7878cbeac04860b8b5e0ca31d3abad3df9411a75a32cde82f8e44b6c16ff650 + # via mkdocs +mkdocs-material==9.7.7 \ + --hash=sha256:8ea9bb1737a5b524a5f9dcf2e1b4ebda8274ae3008aa7845720a97083bef708f \ + --hash=sha256:c0649c065b1b0512d60aad8c10f947f8e455284475239b364b610f2deb4d0855 + # via octoform-docs (pyproject.toml) +mkdocs-material-extensions==1.3.1 \ + --hash=sha256:10c9511cea88f568257f960358a467d12b970e1f7b2c0e5fb2bb48cab1928443 \ + --hash=sha256:adff8b62700b25cb77b53358dad940f3ef973dd6db797907c49e3c2ef3ab4e31 + # via mkdocs-material +packaging==26.3 \ + --hash=sha256:94edc256424af38762eb31306eed28beb9f0efc50a8837492c9d6fd6004aed79 \ + --hash=sha256:d7193f7c8e4e93f444fde0262bf90af30e16fa0ad0ad44cb553c87339b23cd1c + # via mkdocs +paginate==0.5.7 \ + --hash=sha256:22bd083ab41e1a8b4f3690544afb2c60c25e5c9a63a30fa2f483f6c60c8e5945 \ + --hash=sha256:b885e2af73abcf01d9559fd5216b57ef722f8c42affbb63942377668e35c7591 + # via mkdocs-material +pathspec==1.1.1 \ + --hash=sha256:17db5ecd524104a120e173814c90367a96a98d07c45b2e10c2f3919fff91bf5a \ + --hash=sha256:a00ce642f577bf7f473932318056212bc4f8bfdf53128c78bbd5af0b9b20b189 + # via mkdocs +platformdirs==4.11.2 \ + --hash=sha256:3a2ae5fca3520a01ab1be8b45613537f52ddf5b5f6f53d88233892dfbf0cd82d \ + --hash=sha256:7f89089b6ea71bda7962953edcf784b2e2d9d285b40ad88be2bb75c6e9d82ab4 + # via mkdocs-get-deps +pygments==2.20.0 \ + --hash=sha256:6757cd03768053ff99f3039c1a36d6c0aa0b263438fcab17520b30a303a82b5f \ + --hash=sha256:81a9e26dd42fd28a23a2d169d86d7ac03b46e2f8b59ed4698fb4785f946d0176 + # via mkdocs-material +pymdown-extensions==11.0.1 \ + --hash=sha256:db3943a62bab7e03af1364f0c4083e64b91fb097675a4b6cceccfbe9a77e5eb2 \ + --hash=sha256:dd2905ae6fc5b75582fafb139a1266ffc754705efa902aa50067fa7ff4f94ec0 + # via mkdocs-material +pyparsing==3.3.2 \ + --hash=sha256:850ba148bd908d7e2411587e247a1e4f0327839c40e2e5e6d05a007ecc69911d \ + --hash=sha256:c777f4d763f140633dcb6d8a3eda953bf7a214dc4eff598413c070bcdc117cbc + # via mike +python-dateutil==2.9.0.post0 \ + --hash=sha256:37dd54208da7e1cd875388217d5e00ebd4179249f90fb72437e91a35459a0ad3 \ + --hash=sha256:a8b2bc7bffae282281c8140a97d3aa9c14da0b136dfe83f850eea9a5f7470427 + # via ghp-import +pyyaml==6.0.3 \ + --hash=sha256:00c4bdeba853cc34e7dd471f16b4114f4162dc03e6b7afcc2128711f0eca823c \ + --hash=sha256:0150219816b6a1fa26fb4699fb7daa9caf09eb1999f3b70fb6e786805e80375a \ + --hash=sha256:02893d100e99e03eda1c8fd5c441d8c60103fd175728e23e431db1b589cf5ab3 \ + --hash=sha256:02ea2dfa234451bbb8772601d7b8e426c2bfa197136796224e50e35a78777956 \ + --hash=sha256:0f29edc409a6392443abf94b9cf89ce99889a1dd5376d94316ae5145dfedd5d6 \ + --hash=sha256:10892704fc220243f5305762e276552a0395f7beb4dbf9b14ec8fd43b57f126c \ + --hash=sha256:16249ee61e95f858e83976573de0f5b2893b3677ba71c9dd36b9cf8be9ac6d65 \ + --hash=sha256:1d37d57ad971609cf3c53ba6a7e365e40660e3be0e5175fa9f2365a379d6095a \ + --hash=sha256:1ebe39cb5fc479422b83de611d14e2c0d3bb2a18bbcb01f229ab3cfbd8fee7a0 \ + --hash=sha256:214ed4befebe12df36bcc8bc2b64b396ca31be9304b8f59e25c11cf94a4c033b \ + --hash=sha256:2283a07e2c21a2aa78d9c4442724ec1eb15f5e42a723b99cb3d822d48f5f7ad1 \ + --hash=sha256:22ba7cfcad58ef3ecddc7ed1db3409af68d023b7f940da23c6c2a1890976eda6 \ + --hash=sha256:27c0abcb4a5dac13684a37f76e701e054692a9b2d3064b70f5e4eb54810553d7 \ + --hash=sha256:28c8d926f98f432f88adc23edf2e6d4921ac26fb084b028c733d01868d19007e \ + --hash=sha256:2e71d11abed7344e42a8849600193d15b6def118602c4c176f748e4583246007 \ + --hash=sha256:34d5fcd24b8445fadc33f9cf348c1047101756fd760b4dacb5c3e99755703310 \ + --hash=sha256:37503bfbfc9d2c40b344d06b2199cf0e96e97957ab1c1b546fd4f87e53e5d3e4 \ + --hash=sha256:3c5677e12444c15717b902a5798264fa7909e41153cdf9ef7ad571b704a63dd9 \ + --hash=sha256:3ff07ec89bae51176c0549bc4c63aa6202991da2d9a6129d7aef7f1407d3f295 \ + --hash=sha256:41715c910c881bc081f1e8872880d3c650acf13dfa8214bad49ed4cede7c34ea \ + --hash=sha256:418cf3f2111bc80e0933b2cd8cd04f286338bb88bdc7bc8e6dd775ebde60b5e0 \ + --hash=sha256:44edc647873928551a01e7a563d7452ccdebee747728c1080d881d68af7b997e \ + --hash=sha256:4a2e8cebe2ff6ab7d1050ecd59c25d4c8bd7e6f400f5f82b96557ac0abafd0ac \ + --hash=sha256:4ad1906908f2f5ae4e5a8ddfce73c320c2a1429ec52eafd27138b7f1cbe341c9 \ + --hash=sha256:501a031947e3a9025ed4405a168e6ef5ae3126c59f90ce0cd6f2bfc477be31b7 \ + --hash=sha256:5190d403f121660ce8d1d2c1bb2ef1bd05b5f68533fc5c2ea899bd15f4399b35 \ + --hash=sha256:5498cd1645aa724a7c71c8f378eb29ebe23da2fc0d7a08071d89469bf1d2defb \ + --hash=sha256:5cf4e27da7e3fbed4d6c3d8e797387aaad68102272f8f9752883bc32d61cb87b \ + --hash=sha256:5e0b74767e5f8c593e8c9b5912019159ed0533c70051e9cce3e8b6aa699fcd69 \ + --hash=sha256:5ed875a24292240029e4483f9d4a4b8a1ae08843b9c54f43fcc11e404532a8a5 \ + --hash=sha256:5fcd34e47f6e0b794d17de1b4ff496c00986e1c83f7ab2fb8fcfe9616ff7477b \ + --hash=sha256:5fdec68f91a0c6739b380c83b951e2c72ac0197ace422360e6d5a959d8d97b2c \ + --hash=sha256:6344df0d5755a2c9a276d4473ae6b90647e216ab4757f8426893b5dd2ac3f369 \ + --hash=sha256:64386e5e707d03a7e172c0701abfb7e10f0fb753ee1d773128192742712a98fd \ + --hash=sha256:652cb6edd41e718550aad172851962662ff2681490a8a711af6a4d288dd96824 \ + --hash=sha256:66291b10affd76d76f54fad28e22e51719ef9ba22b29e1d7d03d6777a9174198 \ + --hash=sha256:66e1674c3ef6f541c35191caae2d429b967b99e02040f5ba928632d9a7f0f065 \ + --hash=sha256:6adc77889b628398debc7b65c073bcb99c4a0237b248cacaf3fe8a557563ef6c \ + --hash=sha256:79005a0d97d5ddabfeeea4cf676af11e647e41d81c9a7722a193022accdb6b7c \ + --hash=sha256:7c6610def4f163542a622a73fb39f534f8c101d690126992300bf3207eab9764 \ + --hash=sha256:7f047e29dcae44602496db43be01ad42fc6f1cc0d8cd6c83d342306c32270196 \ + --hash=sha256:8098f252adfa6c80ab48096053f512f2321f0b998f98150cea9bd23d83e1467b \ + --hash=sha256:850774a7879607d3a6f50d36d04f00ee69e7fc816450e5f7e58d7f17f1ae5c00 \ + --hash=sha256:8d1fab6bb153a416f9aeb4b8763bc0f22a5586065f86f7664fc23339fc1c1fac \ + --hash=sha256:8da9669d359f02c0b91ccc01cac4a67f16afec0dac22c2ad09f46bee0697eba8 \ + --hash=sha256:8dc52c23056b9ddd46818a57b78404882310fb473d63f17b07d5c40421e47f8e \ + --hash=sha256:9149cad251584d5fb4981be1ecde53a1ca46c891a79788c0df828d2f166bda28 \ + --hash=sha256:93dda82c9c22deb0a405ea4dc5f2d0cda384168e466364dec6255b293923b2f3 \ + --hash=sha256:96b533f0e99f6579b3d4d4995707cf36df9100d67e0c8303a0c55b27b5f99bc5 \ + --hash=sha256:9c57bb8c96f6d1808c030b1687b9b5fb476abaa47f0db9c0101f5e9f394e97f4 \ + --hash=sha256:9c7708761fccb9397fe64bbc0395abcae8c4bf7b0eac081e12b809bf47700d0b \ + --hash=sha256:9f3bfb4965eb874431221a3ff3fdcddc7e74e3b07799e0e84ca4a0f867d449bf \ + --hash=sha256:a33284e20b78bd4a18c8c2282d549d10bc8408a2a7ff57653c0cf0b9be0afce5 \ + --hash=sha256:a80cb027f6b349846a3bf6d73b5e95e782175e52f22108cfa17876aaeff93702 \ + --hash=sha256:b30236e45cf30d2b8e7b3e85881719e98507abed1011bf463a8fa23e9c3e98a8 \ + --hash=sha256:b3bc83488de33889877a0f2543ade9f70c67d66d9ebb4ac959502e12de895788 \ + --hash=sha256:b865addae83924361678b652338317d1bd7e79b1f4596f96b96c77a5a34b34da \ + --hash=sha256:b8bb0864c5a28024fac8a632c443c87c5aa6f215c0b126c449ae1a150412f31d \ + --hash=sha256:ba1cc08a7ccde2d2ec775841541641e4548226580ab850948cbfda66a1befcdc \ + --hash=sha256:bdb2c67c6c1390b63c6ff89f210c8fd09d9a1217a465701eac7316313c915e4c \ + --hash=sha256:c1ff362665ae507275af2853520967820d9124984e0f7466736aea23d8611fba \ + --hash=sha256:c2514fceb77bc5e7a2f7adfaa1feb2fb311607c9cb518dbc378688ec73d8292f \ + --hash=sha256:c3355370a2c156cffb25e876646f149d5d68f5e0a3ce86a5084dd0b64a994917 \ + --hash=sha256:c458b6d084f9b935061bc36216e8a69a7e293a2f1e68bf956dcd9e6cbcd143f5 \ + --hash=sha256:d0eae10f8159e8fdad514efdc92d74fd8d682c933a6dd088030f3834bc8e6b26 \ + --hash=sha256:d76623373421df22fb4cf8817020cbb7ef15c725b9d5e45f17e189bfc384190f \ + --hash=sha256:ebc55a14a21cb14062aa4162f906cd962b28e2e9ea38f9b4391244cd8de4ae0b \ + --hash=sha256:eda16858a3cab07b80edaf74336ece1f986ba330fdb8ee0d6c0d68fe82bc96be \ + --hash=sha256:ee2922902c45ae8ccada2c5b501ab86c36525b883eff4255313a253a3160861c \ + --hash=sha256:efd7b85f94a6f21e4932043973a7ba2613b059c4a000551892ac9f1d11f5baf3 \ + --hash=sha256:f7057c9a337546edc7973c0d3ba84ddcdf0daa14533c2065749c9075001090e6 \ + --hash=sha256:fa160448684b4e94d80416c0fa4aac48967a969efe22931448d853ada8baf926 \ + --hash=sha256:fc09d0aa354569bc501d4e787133afc08552722d3ab34836a80547331bb5d4a0 + # via + # mike + # mkdocs + # mkdocs-get-deps + # pymdown-extensions + # pyyaml-env-tag +pyyaml-env-tag==1.1 \ + --hash=sha256:17109e1a528561e32f026364712fee1264bc2ea6715120891174ed1b980d2e04 \ + --hash=sha256:2eb38b75a2d21ee0475d6d97ec19c63287a7e140231e4214969d0eac923cd7ff + # via + # mike + # mkdocs +requests==2.34.2 \ + --hash=sha256:2a0d60c172f83ac6ab31e4554906c0f3b3588d37b5cb939b1c061f4907e278e0 \ + --hash=sha256:f288924cae4e29463698d6d60bc6a4da69c89185ad1e0bcc4104f584e960b9ed + # via mkdocs-material +six==1.17.0 \ + --hash=sha256:4721f391ed90541fddacab5acf947aa0d3dc7d27b2e1e8eda2be8970586c3274 \ + --hash=sha256:ff70335d468e7eb6ec65b95b99d3a2836546063f63acc5171de367e834932a81 + # via python-dateutil +urllib3==2.7.0 \ + --hash=sha256:231e0ec3b63ceb14667c67be60f2f2c40a518cb38b03af60abc813da26505f4c \ + --hash=sha256:9fb4c81ebbb1ce9531cce37674bbc6f1360472bc18ca9a553ede278ef7276897 + # via requests +verspec==0.1.0 \ + --hash=sha256:741877d5633cc9464c45a469ae2a31e801e6dbbaa85b9675d481cda100f11c31 \ + --hash=sha256:c4504ca697b2056cdb4bfa7121461f5a0e81809255b41c03dda4ba823637c01e + # via mike +watchdog==6.0.0 \ + --hash=sha256:07df1fdd701c5d4c8e55ef6cf55b8f0120fe1aef7ef39a1c6fc6bc2e606d517a \ + --hash=sha256:20ffe5b202af80ab4266dcd3e91aae72bf2da48c0d33bdb15c66658e685e94e2 \ + --hash=sha256:212ac9b8bf1161dc91bd09c048048a95ca3a4c4f5e5d4a7d1b1a7d5752a7f96f \ + --hash=sha256:2cce7cfc2008eb51feb6aab51251fd79b85d9894e98ba847408f662b3395ca3c \ + --hash=sha256:490ab2ef84f11129844c23fb14ecf30ef3d8a6abafd3754a6f75ca1e6654136c \ + --hash=sha256:6eb11feb5a0d452ee41f824e271ca311a09e250441c262ca2fd7ebcf2461a06c \ + --hash=sha256:6f10cb2d5902447c7d0da897e2c6768bca89174d0c6e1e30abec5421af97a5b0 \ + --hash=sha256:7607498efa04a3542ae3e05e64da8202e58159aa1fa4acddf7678d34a35d4f13 \ + --hash=sha256:76aae96b00ae814b181bb25b1b98076d5fc84e8a53cd8885a318b42b6d3a5134 \ + --hash=sha256:7a0e56874cfbc4b9b05c60c8a1926fedf56324bb08cfbc188969777940aef3aa \ + --hash=sha256:82dc3e3143c7e38ec49d61af98d6558288c415eac98486a5c581726e0737c00e \ + --hash=sha256:9041567ee8953024c83343288ccc458fd0a2d811d6a0fd68c4c22609e3490379 \ + --hash=sha256:90c8e78f3b94014f7aaae121e6b909674df5b46ec24d6bebc45c44c56729af2a \ + --hash=sha256:9513f27a1a582d9808cf21a07dae516f0fab1cf2d7683a742c498b93eedabb11 \ + --hash=sha256:9ddf7c82fda3ae8e24decda1338ede66e1c99883db93711d8fb941eaa2d8c282 \ + --hash=sha256:a175f755fc2279e0b7312c0035d52e27211a5bc39719dd529625b1930917345b \ + --hash=sha256:a1914259fa9e1454315171103c6a30961236f508b9b623eae470268bbcc6a22f \ + --hash=sha256:afd0fe1b2270917c5e23c2a65ce50c2a4abb63daafb0d419fde368e272a76b7c \ + --hash=sha256:bc64ab3bdb6a04d69d4023b29422170b74681784ffb9463ed4870cf2f3e66112 \ + --hash=sha256:bdd4e6f14b8b18c334febb9c4425a878a2ac20efd1e0b231978e7b150f92a948 \ + --hash=sha256:c7ac31a19f4545dd92fc25d200694098f42c9a8e391bc00bdd362c5736dbf881 \ + --hash=sha256:c7c15dda13c4eb00d6fb6fc508b3c0ed88b9d5d374056b239c4ad1611125c860 \ + --hash=sha256:c897ac1b55c5a1461e16dae288d22bb2e412ba9807df8397a635d88f671d36c3 \ + --hash=sha256:cbafb470cf848d93b5d013e2ecb245d4aa1c8fd0504e863ccefa32445359d680 \ + --hash=sha256:d1cdb490583ebd691c012b3d6dae011000fe42edb7a82ece80965b42abd61f26 \ + --hash=sha256:e3df4cbb9a450c6d49318f6d14f4bbc80d763fa587ba46ec86f99f9e6876bb26 \ + --hash=sha256:e6439e374fc012255b4ec786ae3c4bc838cd7309a540e5fe0952d03687d8804e \ + --hash=sha256:e6f0e77c9417e7cd62af82529b10563db3423625c5fce018430b249bf977f9e8 \ + --hash=sha256:e7631a77ffb1f7d2eefa4445ebbee491c720a5661ddf6df3498ebecae5ed375c \ + --hash=sha256:ef810fbf7b781a5a593894e4f439773830bdecb885e6880d957d5b9382a960d2 + # via mkdocs diff --git a/scripts/build.mjs b/scripts/build.mjs new file mode 100644 index 0000000..a7db5bb --- /dev/null +++ b/scripts/build.mjs @@ -0,0 +1,24 @@ +import { existsSync } from 'node:fs'; +import { spawnSync } from 'node:child_process'; +import { dirname, resolve } from 'node:path'; +import { fileURLToPath } from 'node:url'; + +const root = resolve(dirname(fileURLToPath(import.meta.url)), '..'); +const windowsMkDocs = resolve(root, '.venv/Scripts/mkdocs.exe'); +const unixMkDocs = resolve(root, '.venv/bin/mkdocs'); +const mkdocs = process.env.MKDOCS ?? + (existsSync(windowsMkDocs) ? windowsMkDocs : existsSync(unixMkDocs) ? unixMkDocs : 'mkdocs'); + +process.env.NO_MKDOCS_2_WARNING = 'true'; +run(mkdocs, ['build', '--strict']); + +function runNpm(script) { + if (!process.env.npm_execpath) throw new Error('npm_execpath is unavailable'); + run(process.execPath, [process.env.npm_execpath, 'run', script]); +} + +function run(command, args) { + const result = spawnSync(command, args, { cwd: root, stdio: 'inherit' }); + if (result.error) throw result.error; + if (result.status !== 0) process.exit(result.status ?? 1); +} diff --git a/scripts/release-version.mjs b/scripts/release-version.mjs new file mode 100644 index 0000000..77e1114 --- /dev/null +++ b/scripts/release-version.mjs @@ -0,0 +1,152 @@ +const COMPLETE_VERSION = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/; +const RELEASE_LINE = /^(0|[1-9]\d*)\.(0|[1-9]\d*)$/; + +/** + * Parses a complete stable semantic version. + * + * @param {string} value Version without a `v` prefix. + * @param {string} [label] Value name used in validation errors. + * @returns {{major: number, minor: number, patch: number, version: string}} + */ +export function parseCompleteVersion(value, label = 'Version') { + const match = COMPLETE_VERSION.exec(value ?? ''); + if (!match) { + throw new Error(`${label} must be a complete stable MAJOR.MINOR.PATCH version`); + } + const [, major, minor, patch] = match; + return { + major: Number(major), + minor: Number(minor), + patch: Number(patch), + version: `${major}.${minor}.${patch}`, + }; +} + +/** + * Parses a stable semantic-version release line. + * + * @param {string} value Version line without a `v` prefix. + * @param {string} [label] Value name used in validation errors. + * @returns {{major: number, minor: number, version: string}} + */ +export function parseReleaseLine(value, label = 'Release line') { + const match = RELEASE_LINE.exec(value ?? ''); + if (!match) throw new Error(`${label} must be a complete MAJOR.MINOR release line`); + const [, major, minor] = match; + return { major: Number(major), minor: Number(minor), version: `${major}.${minor}` }; +} + +/** + * Finds exact patch paths that must remain redirects for a documentation line. + * + * @param {Array<{version?: unknown, aliases?: unknown}>} entries Mike version records. + * @param {string} releaseLine Documentation release line. + * @returns {{versions: string[], redirects: string[]}} + */ +export function collectPatchDocumentationPaths(entries, releaseLine) { + if (!Array.isArray(entries)) throw new Error('Mike versions must be an array'); + const { version: line } = parseReleaseLine(releaseLine); + const escapedLine = line.replace(/[.*+?^${}()|[\]\\]/gu, '\\$&'); + const exactPatch = new RegExp(`^${escapedLine}\\.\\d+$`, 'u'); + const versions = new Set(); + const redirects = new Set(); + + for (const entry of entries) { + if (!entry || typeof entry !== 'object') continue; + if (typeof entry.version === 'string' && exactPatch.test(entry.version)) { + versions.add(entry.version); + redirects.add(entry.version); + } + if (!Array.isArray(entry.aliases)) continue; + for (const alias of entry.aliases) { + if (typeof alias === 'string' && exactPatch.test(alias)) redirects.add(alias); + } + } + + const byPatch = (left, right) => Number(left.slice(line.length + 1)) - Number(right.slice(line.length + 1)); + return { versions: [...versions].sort(byPatch), redirects: [...redirects].sort(byPatch) }; +} + +/** + * Returns the compatibility line for a complete semantic version. + * + * @param {string} version Complete stable semantic version. + * @returns {string} + */ +export function releaseLine(version) { + const parsed = parseCompleteVersion(version); + return `${parsed.major}.${parsed.minor}`; +} + +/** + * Parses Git tag references, peeling annotated tags to their source commits. + * + * @param {string} output Tab-separated `git for-each-ref` output. + * @returns {{name: string, target: string}[]} + */ +export function parseTagReferences(output) { + return output.split(/\r?\n/u).filter(Boolean).map((line) => { + const [name, peeledTarget, directTarget] = line.split('\t'); + if (!name || !(peeledTarget || directTarget)) throw new Error('Invalid Git tag reference'); + return { name, target: peeledTarget || directTarget }; + }); +} + +/** + * Resolves the immutable publication assigned to a documentation source commit. + * + * @param {{applicationVersion: string, allTags: string[], commitTags: string[]}} input + * @returns {{applicationVersion: string, applicationLine: string, publicationVersion: string, publicationTag: string, reused: boolean, publishDocumentationLine: boolean}} + */ +export function resolveDocumentationRelease({ applicationVersion, allTags, commitTags }) { + const application = parseCompleteVersion(applicationVersion, 'rup-flow version'); + const applicationLine = `${application.major}.${application.minor}`; + const parseTag = (tag) => { + if (!tag.startsWith('v')) return undefined; + try { + return { tag, ...parseCompleteVersion(tag.slice(1), 'Documentation tag') }; + } catch { + return undefined; + } + }; + const existing = [...new Set(allTags)].map(parseTag).filter(Boolean); + const onCommit = [...new Set(commitTags)].map(parseTag).filter(Boolean); + const linePatches = existing + .filter(({ major, minor }) => major === application.major && minor === application.minor) + .map(({ patch }) => patch); + if (onCommit.length > 1) { + throw new Error('A documentation source commit cannot have multiple release tags'); + } + if (onCommit.length === 1) { + const current = onCommit[0]; + if (!existing.some(({ tag }) => tag === current.tag)) { + throw new Error(`Commit tag ${current.tag} is missing from the repository tag set`); + } + if (`${current.major}.${current.minor}` !== applicationLine) { + throw new Error( + `Existing documentation tag ${current.tag} does not match rup-flow release line ${applicationLine}`, + ); + } + return { + applicationVersion: application.version, + applicationLine, + publicationVersion: current.version, + publicationTag: current.tag, + reused: true, + publishDocumentationLine: current.patch === Math.max(...linePatches), + }; + } + const patch = linePatches.length === 0 ? 0 : Math.max(...linePatches) + 1; + if (!Number.isSafeInteger(patch)) { + throw new Error(`Documentation publication patch overflow for ${applicationLine}`); + } + const publicationVersion = `${applicationLine}.${patch}`; + return { + applicationVersion: application.version, + applicationLine, + publicationVersion, + publicationTag: `v${publicationVersion}`, + reused: false, + publishDocumentationLine: true, + }; +} diff --git a/scripts/render-diagrams.mjs b/scripts/render-diagrams.mjs new file mode 100644 index 0000000..3e47c4c --- /dev/null +++ b/scripts/render-diagrams.mjs @@ -0,0 +1,64 @@ +import { existsSync, readFileSync, readdirSync } from 'node:fs'; +import { spawnSync } from 'node:child_process'; +import { dirname, resolve } from 'node:path'; +import { fileURLToPath } from 'node:url'; + +const root = resolve(dirname(fileURLToPath(import.meta.url)), '..'); +const sourceDirectory = resolve(root, 'docs/assets/diagrams/sources'); +const outputDirectory = resolve(root, 'docs/assets/diagrams'); +const image = 'ghcr.io/plantuml/plantuml@sha256:47870c1f76cfb3747bc7090bfe83013a4e3105b5a0bb1515e2baf5d3e2b3ee9d'; +const sources = readdirSync(sourceDirectory) + .filter((file) => file.endsWith('.puml')) + .sort(); + +if (sources.length === 0) throw new Error('No PlantUML sources were found.'); + +const previous = process.argv.includes('--check') + ? new Map(sources.map((source) => [outputName(source), readOutput(outputName(source))])) + : null; + +const result = spawnSync( + 'docker', + [ + 'run', + '--rm', + '--volume', + `${root}:/workspace`, + '--workdir', + '/workspace', + image, + '-tsvg', + '-charset', + 'UTF-8', + '-o', + '..', + ...sources.map((source) => `docs/assets/diagrams/sources/${source}`), + ], + { cwd: root, encoding: 'utf8' }, +); + +if (result.error) throw result.error; +if (result.status !== 0) { + process.stderr.write(result.stderr || result.stdout); + process.exit(result.status ?? 1); +} + +if (previous) { + const changed = sources + .map(outputName) + .filter((output) => !previous.get(output)?.equals(readOutput(output))); + if (changed.length > 0) { + throw new Error(`Generated diagrams were stale: ${changed.join(', ')}`); + } +} + +console.log(`${previous ? 'Validated' : 'Rendered'} ${sources.length} PlantUML diagram${sources.length === 1 ? '' : 's'}.`); + +function outputName(source) { + return source.replace(/\.puml$/, '.svg'); +} + +function readOutput(output) { + const path = resolve(outputDirectory, output); + return existsSync(path) ? readFileSync(path) : undefined; +} diff --git a/scripts/resolve-release.mjs b/scripts/resolve-release.mjs new file mode 100644 index 0000000..e1e047b --- /dev/null +++ b/scripts/resolve-release.mjs @@ -0,0 +1,48 @@ +import { appendFile, readFile } from 'node:fs/promises'; +import { spawnSync } from 'node:child_process'; +import { dirname, resolve } from 'node:path'; +import { fileURLToPath } from 'node:url'; +import { parseTagReferences, resolveDocumentationRelease } from './release-version.mjs'; + +const root = resolve(dirname(fileURLToPath(import.meta.url)), '..'); +const sourceCommit = process.argv[2]; +if (!/^[0-9a-f]{40}$/i.test(sourceCommit ?? '')) { + throw new Error('Source commit must be a complete Git object ID'); +} + +const packageJson = JSON.parse(await readFile(resolve(root, 'package.json'), 'utf8')); +const applicationVersion = packageJson.rupFlow?.version; +const tagReferences = readTagReferences(); +const allTags = tagReferences.map(({ name }) => name); +const commitTags = tagReferences + .filter(({ target }) => target.toLowerCase() === sourceCommit.toLowerCase()) + .map(({ name }) => name); +const release = resolveDocumentationRelease({ applicationVersion, allTags, commitTags }); +const output = { + application_version: release.applicationVersion, + application_line: release.applicationLine, + publication_version: release.publicationVersion, + publication_tag: release.publicationTag, + reused: String(release.reused), + publish_documentation_line: String(release.publishDocumentationLine), +}; + +if (process.env.GITHUB_OUTPUT) { + await appendFile( + process.env.GITHUB_OUTPUT, + `${Object.entries(output).map(([key, value]) => `${key}=${value}`).join('\n')}\n`, + ); +} +console.log(JSON.stringify(output)); + +function readTagReferences() { + const format = '%(refname:strip=2)%09%(*objectname)%09%(objectname)'; + const result = spawnSync( + 'git', + ['for-each-ref', `--format=${format}`, 'refs/tags/v*.*.*'], + { cwd: root, encoding: 'utf8' }, + ); + if (result.error) throw result.error; + if (result.status !== 0) throw new Error(result.stderr.trim() || 'Unable to inspect Git tags'); + return parseTagReferences(result.stdout); +} diff --git a/scripts/scan-secrets.mjs b/scripts/scan-secrets.mjs new file mode 100644 index 0000000..4d8dae1 --- /dev/null +++ b/scripts/scan-secrets.mjs @@ -0,0 +1,41 @@ +import { readFile, readdir } from 'node:fs/promises'; +import { dirname, relative, resolve } from 'node:path'; +import { fileURLToPath } from 'node:url'; + +const root = resolve(dirname(fileURLToPath(import.meta.url)), '..'); +const ignoredDirectories = new Set(['.cache', '.git', '.venv', 'node_modules', 'site']); +const ignoredFiles = new Set(['package-lock.json', 'requirements.lock']); +const patterns = [ + { name: 'GitHub token', expression: /\bgh[pousr]_[A-Za-z0-9_]{36,}\b/g }, + { name: 'GitHub fine-grained token', expression: /\bgithub_pat_[A-Za-z0-9_]{20,}\b/g }, + { name: 'private key', expression: /-----BEGIN (?:RSA |EC |OPENSSH )?PRIVATE KEY-----/g }, + { name: 'AWS access key', expression: /\bAKIA[0-9A-Z]{16}\b/g }, +]; +const findings = []; + +for (const file of await sourceFiles(root)) { + const source = await readFile(file, 'utf8'); + for (const pattern of patterns) { + for (const match of source.matchAll(pattern.expression)) { + const line = source.slice(0, match.index).split(/\r?\n/).length; + findings.push(`${relative(root, file)}:${line}: ${pattern.name}`); + } + } +} + +if (findings.length) throw new Error(`Potential secrets detected:\n${findings.join('\n')}`); +console.log('No credential patterns detected.'); + +async function sourceFiles(directory) { + const entries = await readdir(directory, { withFileTypes: true }); + const files = []; + for (const entry of entries) { + if (entry.isDirectory() && ignoredDirectories.has(entry.name)) continue; + if (entry.isFile() && ignoredFiles.has(entry.name)) continue; + const path = resolve(directory, entry.name); + if (entry.isDirectory()) files.push(...(await sourceFiles(path))); + else if (entry.isFile()) files.push(path); + } + return files; +} + diff --git a/scripts/validate-a11y.mjs b/scripts/validate-a11y.mjs new file mode 100644 index 0000000..36020c5 --- /dev/null +++ b/scripts/validate-a11y.mjs @@ -0,0 +1,115 @@ +import { createReadStream, existsSync, statSync } from 'node:fs'; +import { createServer } from 'node:http'; +import { dirname, extname, join, normalize, resolve } from 'node:path'; +import { fileURLToPath } from 'node:url'; +import AxeBuilder from '@axe-core/playwright'; +import { chromium } from 'playwright'; + +const root = resolve(dirname(fileURLToPath(import.meta.url)), '..'); +const site = resolve(root, 'site'); +const server = createServer(serveStaticFile); +await new Promise((resolveListen) => server.listen(0, '127.0.0.1', resolveListen)); +const address = server.address(); +if (!address || typeof address === 'string') throw new Error('Unable to start accessibility server'); +const origin = `http://127.0.0.1:${address.port}`; +const paths = [ + '/', + '/getting-started/', + '/getting-started/installation/', + '/getting-started/authentication/', + '/getting-started/first-policy/', + '/getting-started/first-plan/', + '/getting-started/safe-apply/', + '/configuration/', + '/configuration/branches-and-rulesets/', + '/configuration/security-settings/', + '/commands/', + '/commands/apply/', + '/commands/execution-contract/', + '/guides/plan-and-apply/', + '/automation/', + '/examples/', + '/examples/minimal/', + '/examples/shared-presets/', + '/security/', + '/architecture/', + '/architecture/requirements/actors-and-use-cases/', + '/architecture/software/domain-model/', + '/architecture/behavior/configuration-loading/', + '/architecture/behavior/state-models/', + '/architecture/trust/trust-and-data-flow/', + '/reference/github-api-surface/', + '/troubleshooting/', + '/releases/', + '/releases/publication/', +]; +const mobilePaths = [ + '/', + '/getting-started/', + '/getting-started/authentication/', + '/guides/', + '/examples/minimal/', + '/configuration/branches-and-rulesets/', + '/architecture/behavior/state-models/', + '/security/', + '/releases/', +]; +const browser = await chromium.launch({ headless: true }); +const violations = []; +let scanCount = 0; + +try { + const scenarios = [ + ['desktop', { width: 1440, height: 1200 }, paths], + ['mobile', { width: 390, height: 844 }, mobilePaths], + ]; + for (const [name, viewport, scenarioPaths] of scenarios) { + const context = await browser.newContext({ viewport }); + const page = await context.newPage(); + for (const path of scenarioPaths) { + await page.goto(`${origin}${path}`, { waitUntil: 'networkidle' }); + const result = await new AxeBuilder({ page }) + .withTags(['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa', 'wcag22aa']) + .analyze(); + scanCount += 1; + for (const violation of result.violations) { + for (const node of violation.nodes) { + violations.push( + `${name} ${path}: ${violation.id} (${violation.impact ?? 'unknown'}) ${violation.help}\n` + + ` target: ${node.target.join(' ')}\n` + + ` ${node.failureSummary ?? node.html}`, + ); + } + } + } + await context.close(); + } +} finally { + await browser.close(); + await new Promise((resolveClose, reject) => server.close((error) => (error ? reject(error) : resolveClose()))); +} + +if (violations.length) throw new Error(`Accessibility violations:\n${violations.join('\n')}`); +console.log(`Validated WCAG 2.2 AA accessibility across ${scanCount} desktop and mobile page scans.`); + +function serveStaticFile(request, response) { + const requestPath = decodeURIComponent(new URL(request.url ?? '/', 'http://localhost').pathname); + const safePath = normalize(requestPath).replace(/^(\.\.[/\\])+/, ''); + let file = join(site, safePath); + if (requestPath.endsWith('/')) file = join(file, 'index.html'); + else if (existsSync(file) && statSync(file).isDirectory()) file = join(file, 'index.html'); + if (!file.startsWith(site) || !existsSync(file) || !statSync(file).isFile()) { + response.writeHead(404); + response.end('Not found'); + return; + } + const types = { + '.css': 'text/css; charset=utf-8', + '.html': 'text/html; charset=utf-8', + '.js': 'text/javascript; charset=utf-8', + '.json': 'application/json; charset=utf-8', + '.svg': 'image/svg+xml', + }; + response.writeHead(200, { 'Content-Type': types[extname(file)] ?? 'application/octet-stream' }); + createReadStream(file).pipe(response); +} diff --git a/scripts/validate-deployment.mjs b/scripts/validate-deployment.mjs new file mode 100644 index 0000000..34cde95 --- /dev/null +++ b/scripts/validate-deployment.mjs @@ -0,0 +1,120 @@ +import { createHash } from 'node:crypto'; +import { lstat, readFile, readdir } from 'node:fs/promises'; +import { dirname, relative, resolve, sep } from 'node:path'; +import { fileURLToPath, pathToFileURL } from 'node:url'; + +const documentationRoot = new URL('https://hector-ae21.github.io/rup-flow-docs/'); + +/** + * Validates the exact remote tree prepared for GitHub Pages. + * + * @param {{builtDirectory: string, publishedDirectory: string, version: string, aliases: string[]}} input + */ +export async function validateDeployment({ builtDirectory, publishedDirectory, version, aliases }) { + const canonicalDirectory = resolve(publishedDirectory, version); + const [builtFiles, canonicalFiles] = await Promise.all([ + listFiles(builtDirectory), + listFiles(canonicalDirectory), + ]); + if (JSON.stringify(builtFiles) !== JSON.stringify(canonicalFiles)) { + throw new Error(`Published ${version} file list differs from the generated site`); + } + for (const file of builtFiles) { + const [builtDigest, publishedDigest] = await Promise.all([ + digest(resolve(builtDirectory, file)), + digest(resolve(canonicalDirectory, file)), + ]); + if (builtDigest !== publishedDigest) { + throw new Error(`Published ${version}/${file} differs from the generated site`); + } + } + + const versions = JSON.parse(await readFile(resolve(publishedDirectory, 'versions.json'), 'utf8')); + const selected = versions.find((entry) => entry.version === version); + if (!selected) throw new Error(`versions.json does not contain ${version}`); + if (!versions.some((entry) => entry.aliases.includes('latest'))) { + throw new Error('versions.json does not define the latest alias'); + } + for (const alias of aliases) { + if (!selected.aliases.includes(alias)) { + throw new Error(`Alias ${alias} does not point to ${version} in versions.json`); + } + const aliasDirectory = resolve(publishedDirectory, alias); + const info = await lstat(aliasDirectory); + if (info.isSymbolicLink() || !info.isDirectory()) { + throw new Error(`Alias ${alias} must be a real redirect directory`); + } + const redirect = await readFile(resolve(aliasDirectory, 'index.html'), 'utf8'); + if (!redirect.includes(`../${version}/`)) { + throw new Error(`Alias ${alias} does not redirect to ${version}`); + } + } + const rootRedirect = await readFile(resolve(publishedDirectory, 'index.html'), 'utf8'); + if (!rootRedirect.includes('latest/')) throw new Error('Pages root does not redirect to latest'); + const latestInfo = await lstat(resolve(publishedDirectory, 'latest')); + if (latestInfo.isSymbolicLink() || !latestInfo.isDirectory()) { + throw new Error('Alias latest must be a real redirect directory'); + } + await validateSupersededExits(publishedDirectory, versions); + const publishedFiles = await listFiles(publishedDirectory, { rejectLinks: true }); + if (publishedFiles.length === 0) throw new Error('Published tree is empty'); +} + +/** + * Requires every superseded line to send readers to the documentation root. + * + * A published page is static, so the banner it carries is decided at build + * time and cannot be corrected later from the current line. The link must + * leave the version it was built into. + * + * @param {string} publishedDirectory + * @param {{version: string, aliases: string[]}[]} versions + */ +async function validateSupersededExits(publishedDirectory, versions) { + const current = versions.find((entry) => entry.aliases.includes('latest')); + for (const entry of versions) { + if (!current || entry.version === current.version) continue; + const page = await readFile(resolve(publishedDirectory, entry.version, 'index.html'), 'utf8'); + const banner = /md-banner__inner[\s\S]*? match[1])), + }); +} + +for (const [file, page] of pages) { + for (const match of page.source.matchAll(/\s(?:href|src)=["']([^"']+)["']/g)) { + let value = match[1]; + if (/^(?:mailto:|tel:|data:|javascript:)/i.test(value)) continue; + if (/^https?:/i.test(value)) { + const absolute = new URL(value); + if (absolute.origin !== publishedBase.origin || !absolute.pathname.startsWith(publishedBase.pathname)) { + absolute.hash = ''; + externalLinks.add(absolute.href); + continue; + } + value = `/${absolute.pathname.slice(publishedBase.pathname.length)}${absolute.search}${absolute.hash}`; + } + const url = new URL(value, `https://docs.invalid/${file}`); + let path = decodeURIComponent(url.pathname).replace(/^\/rup-flow-docs\//, '').replace(/^\//, ''); + if (!path || path.endsWith('/')) path += 'index.html'; + if (!extname(path)) path += '/index.html'; + const target = pages.get(path); + if (!target && !existsSync(resolve(site, path))) { + failures.push(`${file}: ${value} resolves to missing ${path}`); + continue; + } + if (url.hash) { + const fragment = decodeURIComponent(url.hash.slice(1)); + if (fragment && target && !target.ids.has(fragment)) { + failures.push(`${file}: ${value} references missing anchor ${fragment}`); + } + } + } +} + +for (const link of externalLinks) { + const failure = await validateExternalLink(link); + if (failure) failures.push(failure); +} + +if (failures.length) throw new Error(`Broken links:\n${failures.join('\n')}`); +console.log( + `Validated internal links and anchors across ${pages.size} generated pages and ` + + `${externalLinks.size} external links.`, +); + +async function htmlFiles(directory) { + const entries = await readdir(directory, { withFileTypes: true }); + const files = []; + for (const entry of entries) { + const path = resolve(directory, entry.name); + if (entry.isDirectory()) files.push(...(await htmlFiles(path))); + else if (entry.name.endsWith('.html')) files.push(path); + } + return files; +} + +async function validateExternalLink(url) { + const target = externalValidationTarget(url); + let lastFailure = ''; + for (let attempt = 1; attempt <= 3; attempt += 1) { + try { + const head = await request(target, 'HEAD'); + if (head.ok || head.status < 400) return ''; + const response = head.status === 403 || head.status === 405 ? await request(target, 'GET') : head; + if (response.ok || response.status < 400) return ''; + lastFailure = `${url} returned HTTP ${response.status}`; + if (response.status !== 429 && response.status < 500) return lastFailure; + } catch (error) { + lastFailure = `${url} failed: ${error instanceof Error ? error.message : String(error)}`; + } + if (attempt < 3) await delay(250 * attempt); + } + return lastFailure; +} + +function externalValidationTarget(url) { + const parsed = new URL(url); + if (parsed.hostname === 'www.npmjs.com' && parsed.pathname.startsWith('/package/')) { + const packageName = decodeURIComponent(parsed.pathname.slice('/package/'.length)); + return `https://registry.npmjs.org/${encodeURIComponent(packageName)}`; + } + return url; +} + +async function request(url, method) { + const response = await fetch(url, { + method, + redirect: 'follow', + headers: { 'User-Agent': 'rup-flow-Docs-Link-Check/1.0' }, + signal: AbortSignal.timeout(10_000), + }); + if (method === 'GET') await response.body?.cancel(); + return response; +} diff --git a/scripts/validate-privacy.mjs b/scripts/validate-privacy.mjs new file mode 100644 index 0000000..d352b3b --- /dev/null +++ b/scripts/validate-privacy.mjs @@ -0,0 +1,68 @@ +import { readFileSync, readdirSync, statSync } from 'node:fs'; +import { dirname, extname, resolve } from 'node:path'; +import { fileURLToPath } from 'node:url'; + +const root = resolve(dirname(fileURLToPath(import.meta.url)), '..'); +const site = resolve(root, 'site'); +const violations = []; + +for (const file of walk(site)) { + const extension = extname(file); + if (extension !== '.html' && extension !== '.css') continue; + + const content = readFileSync(file, 'utf8'); + const patterns = extension === '.html' + ? [ + /<(?:script|img|source|iframe)\b[^>]*\b(?:src|srcset)=["']([^"']+)["']/gi, + ] + : [/url\(\s*["']?(https?:\/\/[^)'"\s]+)/gi, /@import\s+["'](https?:\/\/[^"']+)/gi]; + + for (const pattern of patterns) { + for (const match of content.matchAll(pattern)) { + if (/^https?:\/\//i.test(match[1])) { + violations.push(`${relative(file)} -> ${match[1]}`); + } + } + } + + if (extension === '.html') validateLinkElements(content, file); +} + +if (violations.length > 0) { + console.error('External runtime resources detected:'); + for (const violation of violations) console.error(`- ${violation}`); + process.exit(1); +} + +console.log('No external runtime resources detected in the generated site.'); + +function walk(directory) { + return readdirSync(directory, { withFileTypes: true }).flatMap((entry) => { + const path = resolve(directory, entry.name); + return entry.isDirectory() ? walk(path) : statSync(path).isFile() ? [path] : []; + }); +} + +function relative(file) { + return file.slice(site.length + 1).replaceAll('\\', '/'); +} + +function validateLinkElements(content, file) { + const resourceRelations = new Set([ + 'apple-touch-icon', + 'icon', + 'manifest', + 'modulepreload', + 'preload', + 'stylesheet', + ]); + + for (const match of content.matchAll(/]*>/gi)) { + const tag = match[0]; + const href = tag.match(/\bhref=["']([^"']+)["']/i)?.[1]; + const relations = tag.match(/\brel=["']([^"']+)["']/i)?.[1].split(/\s+/) ?? []; + if (href && /^https?:\/\//i.test(href) && relations.some((relation) => resourceRelations.has(relation))) { + violations.push(`${relative(file)} -> ${href}`); + } + } +} diff --git a/scripts/validate-release.mjs b/scripts/validate-release.mjs new file mode 100644 index 0000000..4863a8a --- /dev/null +++ b/scripts/validate-release.mjs @@ -0,0 +1,45 @@ +import { readFile } from 'node:fs/promises'; +import { dirname, resolve } from 'node:path'; +import { fileURLToPath, pathToFileURL } from 'node:url'; +import { parseCompleteVersion, releaseLine } from './release-version.mjs'; + +const root = resolve(dirname(fileURLToPath(import.meta.url)), '..'); + +/** + * Validates that source metadata describes the selected documentation publication. + * + * @param {{publicationVersion: string, applicationVersion: string, packageJson: string, releasePage: string}} input + */ +export function validateReleaseIdentity({ publicationVersion, applicationVersion, packageJson, releasePage }) { + parseCompleteVersion(publicationVersion, 'Documentation publication version'); + parseCompleteVersion(applicationVersion, 'rup-flow version'); + const applicationLine = releaseLine(applicationVersion); + if (releaseLine(publicationVersion) !== applicationLine) { + throw new Error('Documentation publication and rup-flow release lines do not match'); + } + const packageData = JSON.parse(packageJson); + if (packageData.rupFlow?.version !== applicationVersion) { + throw new Error(`Package metadata does not declare rup-flow ${applicationVersion}`); + } + if (!releasePage.includes(`application_line: "${applicationLine}"`)) { + throw new Error(`Release page does not declare rup-flow release line ${applicationLine}`); + } + if (!releasePage.includes(`validated_application_version: "${applicationVersion}"`)) { + throw new Error(`Release page does not declare validated rup-flow patch ${applicationVersion}`); + } +} + +async function main() { + const publicationVersion = process.argv[2]; + const applicationVersion = process.argv[3]; + const [packageJson, releasePage] = await Promise.all([ + readFile(resolve(root, 'package.json'), 'utf8'), + readFile(resolve(root, 'docs/releases/index.md'), 'utf8'), + ]); + validateReleaseIdentity({ publicationVersion, applicationVersion, packageJson, releasePage }); + console.log( + `Validated documentation publication ${publicationVersion} for rup-flow ${applicationVersion}.`, + ); +} + +if (import.meta.url === pathToFileURL(process.argv[1] ?? '').href) await main(); diff --git a/scripts/verify-pages.mjs b/scripts/verify-pages.mjs new file mode 100644 index 0000000..9785b6d --- /dev/null +++ b/scripts/verify-pages.mjs @@ -0,0 +1,45 @@ +import { setTimeout as delay } from 'node:timers/promises'; +import { parseReleaseLine } from './release-version.mjs'; + +const [baseUrlInput, version, ...aliases] = process.argv.slice(2); +if (!baseUrlInput || !version) { + throw new Error('Usage: verify-pages BASE_URL VERSION [ALIAS...]'); +} +parseReleaseLine(version, 'Documentation version'); +const baseUrl = new URL(baseUrlInput.endsWith('/') ? baseUrlInput : `${baseUrlInput}/`); +await verifyText(new URL(`${version}/`, baseUrl), ['rup-flow', new URL(`${version}/`, baseUrl).href]); +await verifyText(new URL(`${version}/configuration/`, baseUrl), ['rup-flow', 'Configuration']); +await verifyBinary(new URL(`${version}/assets/brand/rup-flow-mark.png`, baseUrl)); +for (const alias of aliases) { + await verifyText(new URL(`${alias}/`, baseUrl), [`../${version}/`]); +} +await verifyText(baseUrl, ['latest/']); +console.log(`Verified documentation ${version} and aliases over HTTPS.`); + +async function request(url) { + let lastError; + for (let attempt = 1; attempt <= 12; attempt += 1) { + try { + const response = await fetch(url, { redirect: 'manual' }); + if (response.ok) return response; + lastError = new Error(`${url} returned HTTP ${response.status}`); + } catch (error) { + lastError = error; + } + await delay(Math.min(attempt * 5_000, 30_000)); + } + throw lastError; +} + +async function verifyText(url, fragments) { + const response = await request(url); + const content = await response.text(); + for (const fragment of fragments) { + if (!content.includes(fragment)) throw new Error(`${url} does not contain ${fragment}`); + } +} + +async function verifyBinary(url) { + const response = await request(url); + if ((await response.arrayBuffer()).byteLength === 0) throw new Error(`${url} is empty`); +} diff --git a/scripts/verify.mjs b/scripts/verify.mjs new file mode 100644 index 0000000..c426b3f --- /dev/null +++ b/scripts/verify.mjs @@ -0,0 +1,34 @@ +import { existsSync } from 'node:fs'; +import { spawnSync } from 'node:child_process'; +import { dirname, resolve } from 'node:path'; +import { fileURLToPath } from 'node:url'; + +const root = resolve(dirname(fileURLToPath(import.meta.url)), '..'); +process.env.NO_MKDOCS_2_WARNING = 'true'; +const windowsMkDocs = resolve(root, '.venv/Scripts/mkdocs.exe'); +const unixMkDocs = resolve(root, '.venv/bin/mkdocs'); +const mkdocs = process.env.MKDOCS ?? + (existsSync(windowsMkDocs) ? windowsMkDocs : existsSync(unixMkDocs) ? unixMkDocs : 'mkdocs'); + +runNpm('lint:markdown'); +runNpm('lint:spelling'); +runNpm('test:release'); +runNpm('validate:diagrams'); +runNpm('validate:secrets'); +run(mkdocs, ['build', '--strict']); +runNpm('validate:html'); +runNpm('validate:links'); +runNpm('validate:privacy'); +runNpm('validate:a11y'); +console.log('Documentation verification completed successfully.'); + +function runNpm(script) { + if (!process.env.npm_execpath) throw new Error('npm_execpath is unavailable'); + run(process.execPath, [process.env.npm_execpath, 'run', script]); +} + +function run(command, args) { + const result = spawnSync(command, args, { cwd: root, stdio: 'inherit' }); + if (result.error) throw result.error; + if (result.status !== 0) process.exit(result.status ?? 1); +} diff --git a/test/release-version.test.mjs b/test/release-version.test.mjs new file mode 100644 index 0000000..1cbd5ba --- /dev/null +++ b/test/release-version.test.mjs @@ -0,0 +1,145 @@ +import assert from 'node:assert/strict'; +import { readFileSync } from 'node:fs'; +import test from 'node:test'; +import { + collectPatchDocumentationPaths, + parseCompleteVersion, + parseReleaseLine, + parseTagReferences, + resolveDocumentationRelease, +} from '../scripts/release-version.mjs'; + +test('preserves canonical and aliased patch paths when publishing a release line', () => { + assert.deepEqual( + collectPatchDocumentationPaths([ + { version: '0.3', aliases: ['0.3.0', 'latest'] }, + { version: '0.3.2', aliases: ['stable'] }, + { version: '0.4', aliases: ['0.4.0'] }, + ], '0.3'), + { versions: ['0.3.2'], redirects: ['0.3.0', '0.3.2'] }, + ); +}); +import { validateReleaseIdentity } from '../scripts/validate-release.mjs'; + +test('selects patch zero for the first documentation release line', () => { + assert.deepEqual( + resolveDocumentationRelease({ applicationVersion: '0.3.1', allTags: [], commitTags: [] }), + { + applicationVersion: '0.3.1', + applicationLine: '0.3', + publicationVersion: '0.3.0', + publicationTag: 'v0.3.0', + reused: false, + publishDocumentationLine: true, + }, + ); +}); + +test('increments only the patch within the matching release line', () => { + const result = resolveDocumentationRelease({ + applicationVersion: '0.3.8', + allTags: ['v0.2.9', 'v0.3.0', 'v0.3.4', 'not-a-release'], + commitTags: [], + }); + assert.equal(result.publicationVersion, '0.3.5'); + assert.equal(result.applicationVersion, '0.3.8'); + assert.equal(result.applicationLine, '0.3'); +}); + +test('reuses the release assigned to the same source commit', () => { + const result = resolveDocumentationRelease({ + applicationVersion: '0.3.9', + allTags: ['v0.3.0', 'v0.3.1'], + commitTags: ['v0.3.1'], + }); + assert.equal(result.publicationVersion, '0.3.1'); + assert.equal(result.applicationVersion, '0.3.9'); + assert.equal(result.reused, true); + assert.equal(result.publishDocumentationLine, true); +}); + +test('does not move aliases backwards when recovering an older tagged commit', () => { + const result = resolveDocumentationRelease({ + applicationVersion: '0.3.9', + allTags: ['v0.3.0', 'v0.3.1'], + commitTags: ['v0.3.0'], + }); + assert.equal(result.publicationVersion, '0.3.0'); + assert.equal(result.publishDocumentationLine, false); +}); + +test('resolves lightweight and annotated tags to their commits', () => { + assert.deepEqual( + parseTagReferences('v0.3.0\t\t1111\nv0.3.1\t2222\taaaa\n'), + [ + { name: 'v0.3.0', target: '1111' }, + { name: 'v0.3.1', target: '2222' }, + ], + ); +}); + +test('rejects prerelease, build, and incomplete versions', () => { + for (const version of ['0.3', '0.3.1-beta.1', '0.3.1+build']) { + assert.throws(() => parseCompleteVersion(version), /complete stable/u); + } +}); + +test('accepts only complete MAJOR.MINOR documentation lines', () => { + assert.deepEqual(parseReleaseLine('0.3'), { major: 0, minor: 3, version: '0.3' }); + for (const version of ['0', '0.3.1', '0.3-beta']) { + assert.throws(() => parseReleaseLine(version), /complete MAJOR\.MINOR/u); + } +}); + +test('rejects a commit tagged for a different rup-flow release line', () => { + assert.throws( + () => resolveDocumentationRelease({ + applicationVersion: '0.4.0', + allTags: ['v0.3.2'], + commitTags: ['v0.3.2'], + }), + /does not match/u, + ); +}); + +test('validates source metadata and exact rup-flow dependency', () => { + assert.doesNotThrow(() => validateReleaseIdentity({ + publicationVersion: '0.3.7', + applicationVersion: '0.3.1', + packageJson: JSON.stringify({ rupFlow: { version: '0.3.1' } }), + releasePage: 'application_line: "0.3"\nvalidated_application_version: "0.3.1"', + })); +}); + +test('rejects documentation and application release-line drift', () => { + assert.throws(() => validateReleaseIdentity({ + publicationVersion: '0.4.0', + applicationVersion: '0.3.1', + packageJson: JSON.stringify({ rupFlow: { version: '0.3.1' } }), + releasePage: 'application_line: "0.3"\nvalidated_application_version: "0.3.1"', + }), /release lines do not match/u); +}); + +test('keeps the validation patch independent from a later editorial publication patch', () => { + const result = resolveDocumentationRelease({ + applicationVersion: '0.3.1', + allTags: Array.from({ length: 25 }, (_, patch) => `v0.3.${patch}`), + commitTags: [], + }); + assert.equal(result.publicationVersion, '0.3.25'); + assert.equal(result.publicationTag, 'v0.3.25'); + assert.equal(result.applicationVersion, '0.3.1'); + assert.equal(result.applicationLine, '0.3'); +}); + +test('publishes the release line to Mike and uses the editorial version only for release records', () => { + const workflow = readFileSync(new URL('../.github/workflows/publish.yml', import.meta.url), 'utf8'); + assert.match(workflow, /mike deploy[\s\S]*"\$APPLICATION_LINE"/u); + assert.doesNotMatch(workflow, /mike deploy[\s\S]{0,180}"\$APPLICATION_VERSION"/u); + assert.doesNotMatch(workflow, /mike deploy[\s\S]{0,180}"\$PUBLICATION_VERSION"/u); + assert.match(workflow, /gh release create "\$PUBLICATION_TAG"/u); + assert.match(workflow, /Documentation publication \$PUBLICATION_VERSION for rup-flow \$APPLICATION_LINE/u); + assert.match(workflow, /Convert exact patch paths to release-line redirects/u); + assert.match(workflow, /validate-deployment\.mjs site[\s\S]*"\$APPLICATION_LINE"/u); + assert.match(workflow, /"\$APPLICATION_LINE" "\$\{PATCH_REDIRECTS\[@\]\}" latest stable/u); +}); diff --git a/test/validate-deployment.test.mjs b/test/validate-deployment.test.mjs new file mode 100644 index 0000000..cbba97e --- /dev/null +++ b/test/validate-deployment.test.mjs @@ -0,0 +1,112 @@ +import assert from 'node:assert/strict'; +import { mkdtemp, mkdir, rm, symlink, writeFile } from 'node:fs/promises'; +import { tmpdir } from 'node:os'; +import { resolve } from 'node:path'; +import test from 'node:test'; +import { validateDeployment } from '../scripts/validate-deployment.mjs'; + +test('accepts an exact immutable tree with redirect aliases', async (context) => { + const fixture = await createFixture(context); + await assert.doesNotReject(() => validateDeployment(fixture)); +}); + +test('accepts an older immutable tree without moving current aliases', async (context) => { + const fixture = await createFixture(context, { aliases: [] }); + await supersede(fixture); + await assert.doesNotReject(() => validateDeployment(fixture)); +}); + +test('rejects a superseded line whose exit stays inside that line', async (context) => { + const fixture = await createFixture(context, { + aliases: [], + exitHref: 'https://hector-ae21.github.io/rup-flow-docs/0.3', + }); + await supersede(fixture); + await assert.rejects(() => validateDeployment(fixture), /sends readers to/u); +}); + +test('rejects a superseded line that offers no exit', async (context) => { + const fixture = await createFixture(context, { aliases: [], exitHref: null }); + await supersede(fixture); + await assert.rejects(() => validateDeployment(fixture), /offers no exit/u); +}); + +test('rejects stale canonical content', async (context) => { + const fixture = await createFixture(context); + await writeFile(resolve(fixture.publishedDirectory, fixture.version, 'index.html'), 'stale'); + await assert.rejects(() => validateDeployment(fixture), /differs from the generated site/u); +}); + +test('rejects symbolic-link aliases', async (context) => { + const fixture = await createFixture(context, { aliases: [] }); + const alias = 'latest'; + try { + await symlink(fixture.version, resolve(fixture.publishedDirectory, alias), 'dir'); + } catch (error) { + if (error.code === 'EPERM') { + context.skip('Creating symbolic links requires elevated Windows privileges'); + return; + } + throw error; + } + await writeVersions(fixture.publishedDirectory, fixture.version, [alias]); + await assert.rejects( + () => validateDeployment({ ...fixture, aliases: [alias] }), + /real redirect directory/u, + ); +}); + +async function supersede({ publishedDirectory, version }) { + await mkdir(resolve(publishedDirectory, 'latest'), { recursive: true }); + await writeFile(resolve(publishedDirectory, 'latest', 'index.html'), '../0.3.1/'); + await writeFile( + resolve(publishedDirectory, 'versions.json'), + `${JSON.stringify([ + { version: '0.3.1', title: '0.3.1', aliases: ['latest'] }, + { version, title: version, aliases: [] }, + ], undefined, 2)}\n`, + ); +} + +function landingPage(exitHref) { + const exit = exitHref === null + ? '' + : ``; + return `

    rup-flow

    `; +} + +async function createFixture( + context, + { + aliases = ['0.3.0', '0.3.1', '0.3.2', 'latest', 'stable'], + exitHref = 'https://hector-ae21.github.io/rup-flow-docs/', + } = {}, +) { + const root = await mkdtemp(resolve(tmpdir(), 'rup-flow-docs-release-')); + context.after(() => rm(root, { recursive: true, force: true })); + const builtDirectory = resolve(root, 'site'); + const publishedDirectory = resolve(root, 'published'); + const version = '0.3'; + const landing = landingPage(exitHref); + await mkdir(resolve(builtDirectory, 'configuration'), { recursive: true }); + await writeFile(resolve(builtDirectory, 'index.html'), landing); + await writeFile(resolve(builtDirectory, 'configuration', 'index.html'), 'Configuration'); + await mkdir(resolve(publishedDirectory, version), { recursive: true }); + await mkdir(resolve(publishedDirectory, version, 'configuration'), { recursive: true }); + await writeFile(resolve(publishedDirectory, version, 'index.html'), landing); + await writeFile(resolve(publishedDirectory, version, 'configuration', 'index.html'), 'Configuration'); + for (const alias of aliases) { + await mkdir(resolve(publishedDirectory, alias), { recursive: true }); + await writeFile(resolve(publishedDirectory, alias, 'index.html'), `../${version}/`); + } + await writeFile(resolve(publishedDirectory, 'index.html'), 'latest/'); + await writeVersions(publishedDirectory, version, aliases); + return { builtDirectory, publishedDirectory, version, aliases }; +} + +async function writeVersions(directory, version, aliases) { + await writeFile( + resolve(directory, 'versions.json'), + `${JSON.stringify([{ version, title: version, aliases }], undefined, 2)}\n`, + ); +} diff --git a/test/workflow-boundaries.test.mjs b/test/workflow-boundaries.test.mjs new file mode 100644 index 0000000..cbedf73 --- /dev/null +++ b/test/workflow-boundaries.test.mjs @@ -0,0 +1,27 @@ +import assert from 'node:assert/strict'; +import { readFileSync } from 'node:fs'; +import test from 'node:test'; + +const pullRequestWorkflow = readFileSync('.github/workflows/pull-request.yml', 'utf8'); +const publishWorkflow = readFileSync('.github/workflows/publish.yml', 'utf8'); + +test('runs complete documentation verification only before merge', () => { + assert.match(pullRequestWorkflow, /^ pull_request:$/mu); + assert.match(pullRequestWorkflow, /^ workflow_dispatch:$/mu); + assert.doesNotMatch(pullRequestWorkflow, /^ push:$/mu); + assert.match(pullRequestWorkflow, /^ name: Verify documentation$/mu); + assert.match(pullRequestWorkflow, /^ run: npm run verify$/mu); + + const completeVerificationRuns = `${pullRequestWorkflow}\n${publishWorkflow}` + .match(/run: npm run verify/gu) ?? []; + assert.equal(completeVerificationRuns.length, 1); +}); + +test('builds publication artifacts without repeating browser verification', () => { + assert.match(publishWorkflow, /^ push:$/mu); + assert.match(publishWorkflow, /^ run: npm run build$/mu); + assert.doesNotMatch(publishWorkflow, /npm run verify/u); + assert.doesNotMatch(publishWorkflow, /playwright install/u); + assert.match(publishWorkflow, /scripts\/validate-deployment\.mjs/u); + assert.match(publishWorkflow, /scripts\/verify-pages\.mjs/u); +}); From a955678428d50edbbcc6fcc71a16a5c992b043c7 Mon Sep 17 00:00:00 2001 From: hector-ae21 Date: Sun, 18 Oct 2026 16:50:20 +0200 Subject: [PATCH 2/2] fix(docs): scan the rup-flow pages in the accessibility check --- scripts/validate-a11y.mjs | 48 ++++++++++++++++----------------------- 1 file changed, 20 insertions(+), 28 deletions(-) diff --git a/scripts/validate-a11y.mjs b/scripts/validate-a11y.mjs index 36020c5..945b2f8 100644 --- a/scripts/validate-a11y.mjs +++ b/scripts/validate-a11y.mjs @@ -16,42 +16,34 @@ const paths = [ '/', '/getting-started/', '/getting-started/installation/', - '/getting-started/authentication/', - '/getting-started/first-policy/', - '/getting-started/first-plan/', - '/getting-started/safe-apply/', + '/getting-started/first-documentation/', + '/getting-started/how-it-works/', + '/guides/', + '/guides/document-a-system/', + '/guides/render-and-check/', + '/reference/cli/', '/configuration/', - '/configuration/branches-and-rulesets/', - '/configuration/security-settings/', - '/commands/', - '/commands/apply/', - '/commands/execution-contract/', - '/guides/plan-and-apply/', - '/automation/', - '/examples/', - '/examples/minimal/', - '/examples/shared-presets/', - '/security/', + '/reference/folder-structure/', + '/diagrams/', + '/diagrams/specification/', '/architecture/', - '/architecture/requirements/actors-and-use-cases/', - '/architecture/software/domain-model/', - '/architecture/behavior/configuration-loading/', - '/architecture/behavior/state-models/', - '/architecture/trust/trust-and-data-flow/', - '/reference/github-api-surface/', - '/troubleshooting/', + '/architecture/editions/', + '/architecture/trust-and-data/', + '/pro/', + '/pro/compare/', + '/pro/themes-and-explorer/', + '/pro/get-pro/', '/releases/', - '/releases/publication/', + '/releases/changelog/', ]; const mobilePaths = [ '/', '/getting-started/', - '/getting-started/authentication/', '/guides/', - '/examples/minimal/', - '/configuration/branches-and-rulesets/', - '/architecture/behavior/state-models/', - '/security/', + '/diagrams/', + '/pro/', + '/pro/compare/', + '/architecture/editions/', '/releases/', ]; const browser = await chromium.launch({ headless: true });