Oxandrolone

.github/workflows/*.yml

@@ -0,0 +1,5 @@
+on:
+  workflow_dispatch: {}   # usuń `push:` i `pull_request:`
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true

.github/workflows/api-export.yml

@@ -0,0 +1,48 @@
+name: API + Exports
+on:
+  workflow_dispatch: {}        # tylko ręcznie
+
+permissions:
+  contents: write
+
+concurrency:
+  group: api-exports-manual
+  cancel-in-progress: false    # nie zabijaj w trakcie
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 0 }
+
+      - uses: actions/setup-node@v4
+        with: { node-version: "20" }
+
+      - run: npm i glob js-yaml --no-save
+      - run: node scripts/extract-api.mjs
+      - run: node scripts/concat-md.mjs mkdocs.yml OTCv8-Docs.md
+      - run: node scripts/normalize-md.mjs OTCv8-Docs.md
+
+      - uses: actions/setup-python@v5
+        with: { python-version: "3.x" }
+      - run: |
+          python -m pip install --upgrade pip
+          pip install mkdocs mkdocs-material mkdocs-macros-plugin mkdocs-git-revision-date-localized-plugin
+      - run: mkdocs build
+
+      - run: |
+          sudo apt-get update && sudo apt-get install -y pandoc zip
+          mkdir -p docs/downloads
+          pandoc OTCv8-Docs.md -f gfm+hard_line_breaks-raw_html -t docx -o docs/downloads/OTCv8-Docs.docx --wrap=none
+          pandoc OTCv8-Docs.md -f gfm+hard_line_breaks-raw_html -t epub -o docs/downloads/OTCv8-Docs.epub --toc --wrap=none
+          zip -r docs/downloads/site.zip site
+          ls -lh docs/downloads
+
+      - name: Commit artefaktów (bez odpalania innych CI)
+        run: |
+          git config user.name "github-actions"
+          git config user.email "actions@github.com"
+          git add -f docs/api/otcv8-full-api.md docs/downloads/*
+          git commit -m "[skip ci] docs: auto API + exports" || echo "no changes"
+          git push

.github/workflows/cleanup.yml

@@ -0,0 +1,126 @@
+name: Bulk cleanup (manual)
+
+on:
+  workflow_dispatch:
+    inputs:
+      delete_artifacts:
+        type: boolean
+        default: true
+        description: Delete all artifacts too
+
+permissions:
+  actions: write
+  contents: read
+  pages: write
+
+concurrency:
+  group: repo-cleanup
+  cancel-in-progress: false
+
+env:
+  OWNER: ${{ github.repository_owner }}
+  REPO:  ${{ github.repository.split('/')[1] }}
+
+jobs:
+  cancel_and_delete:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Cancel queued & in_progress runs
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const owner = process.env.OWNER, repo = process.env.REPO;
+            async function cancelAll(status){
+              for await (const resp of github.paginate.iterator(
+                github.rest.actions.listWorkflowRunsForRepo,
+                { owner, repo, status, per_page: 100 }
+              )) {
+                const runs = resp.data?.workflow_runs || [];
+                for (const run of runs) {
+                  try {
+                    core.info(`Cancel ${status} ${run.id} — ${run.name}`);
+                    await github.rest.actions.cancelWorkflowRun({ owner, repo, run_id: run.id });
+                    await new Promise(r => setTimeout(r, 120));
+                  } catch (e) {
+                    core.warning(`Cancel failed ${run.id}: ${e.message}`);
+                  }
+                }
+              }
+            }
+            await cancelAll('queued');
+            await cancelAll('in_progress');
+
+      - name: Delete completed runs
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const owner = process.env.OWNER, repo = process.env.REPO;
+            let n = 0;
+            for await (const resp of github.paginate.iterator(
+              github.rest.actions.listWorkflowRunsForRepo,
+              { owner, repo, status: 'completed', per_page: 100 }
+            )) {
+              const runs = resp.data?.workflow_runs || [];
+              for (const run of runs) {
+                try {
+                  core.info(`Delete ${run.id} — ${run.name}`);
+                  await github.rest.actions.deleteWorkflowRun({ owner, repo, run_id: run.id });
+                  n++; await new Promise(r => setTimeout(r, 80));
+                } catch (e) {
+                  core.warning(`Delete failed ${run.id}: ${e.message}`);
+                }
+              }
+            }
+            core.notice(`Deleted ${n} completed runs`);
+
+      - name: Delete artifacts (optional)
+        if: ${{ inputs.delete_artifacts }}
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const owner = process.env.OWNER, repo = process.env.REPO;
+            let n = 0;
+            for await (const resp of github.paginate.iterator(
+              github.rest.actions.listArtifactsForRepo,
+              { owner, repo, per_page: 100 }
+            )) {
+              const arts = resp.data?.artifacts || [];
+              for (const a of arts) {
+                try {
+                  core.info(`Delete artifact ${a.id} — ${a.name}`);
+                  await github.rest.actions.deleteArtifact({ owner, repo, artifact_id: a.id });
+                  n++; await new Promise(r => setTimeout(r, 60));
+                } catch (e) {
+                  core.warning(`Artifact delete failed ${a.id}: ${e.message}`);
+                }
+              }
+            }
+            core.notice(`Deleted ${n} artifacts`);
+
+      - name: Cancel GitHub Pages deployments (best-effort)
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const owner = process.env.OWNER, repo = process.env.REPO;
+            try {
+              for await (const resp of github.paginate.iterator(
+                github.request, 'GET /repos/{owner}/{repo}/pages/deployments',
+                { owner, repo, per_page: 100 }
+              )) {
+                const list = Array.isArray(resp.data) ? resp.data : (resp.data?.deployments || []);
+                for (const d of list) {
+                  try {
+                    core.info(`Cancel Pages deployment ${d.id} (${d.status})`);
+                    await github.request(
+                      'POST /repos/{owner}/{repo}/pages/deployments/{deployment_id}/cancel',
+                      { owner, repo, deployment_id: d.id }
+                    );
+                    await new Promise(r => setTimeout(r, 150));
+                  } catch (e) {
+                    core.warning(`Cancel Pages failed ${d?.id}: ${e.message}`);
+                  }
+                }
+              }
+            } catch (e) {
+              core.warning(`Pages API not available: ${e.message}`);
+            }

.github/workflows/docs.yml

@@ -0,0 +1,20 @@
+name: Docs
+on:
+  push:
+    branches: [ master ]
+permissions: { contents: read, pages: write, id-token: write }
+concurrency: { group: pages, cancel-in-progress: true }
+jobs:
+  build-deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with: { python-version: "3.x" }
+      - run: python -m pip install --upgrade pip
+      - run: pip install mkdocs mkdocs-material mkdocs-glightbox mkdocs-macros-plugin mkdocs-git-revision-date-localized-plugin
+      - run: mkdocs build
+      - uses: actions/configure-pages@v5
+      - uses: actions/upload-pages-artifact@v3
+        with: { path: site }
+      - uses: actions/deploy-pages@v4

.github/workflows/exports.yml

@@ -0,0 +1,67 @@
+name: Exports (DOCX/EPUB/ZIP)
+on:
+  push: { branches: [ master ] }
+  workflow_dispatch: {}
+permissions:
+  contents: write
+concurrency:
+  group: exports-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  export:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 0 }
+
+      # 1) Zbuduj scalony MD i stronę
+      - uses: actions/setup-node@v4
+        with: { node-version: "20" }
+      - run: npm install js-yaml glob --no-save
+      - run: node scripts/concat-md.mjs mkdocs.yml OTCv8-Docs.md
+
+      - uses: actions/setup-python@v5
+        with: { python-version: "3.x" }
+      - run: python -m pip install --upgrade pip
+      - run: |
+          pip install \
+            mkdocs \
+            mkdocs-material \
+            mkdocs-glightbox \
+            mkdocs-macros-plugin \
+            mkdocs-git-revision-date-localized-plugin
+      - run: mkdocs build
+
+      # 2) Eksporty
+      - run: |
+          sudo apt-get update && sudo apt-get install -y pandoc zip
+          mkdir -p docs/downloads
+          pandoc OTCv8-Docs.md -o docs/downloads/OTCv8-Docs.docx
+          pandoc OTCv8-Docs.md -o docs/downloads/OTCv8-Docs.epub --toc
+          zip -r docs/downloads/site.zip site
+          ls -lh docs/downloads
+
+      # 3) Commit TYLKO artefaktów (bez workflowów) + twardy reset do origin/master
+      - name: Commit downloads (clean, no-workflows)
+        shell: bash
+        run: |
+          set -e
+          git config user.name "github-actions"
+          git config user.email "actions@github.com"
+
+          # wyzeruj lokalny stan na zdalnym, żeby nie było "unstaged changes"
+          git fetch origin master
+          git reset --hard origin/master
+          git clean -fd
+
+          # dodaj WYŁĄCZNIE pliki z downloads
+          git add -f docs/downloads/OTCv8-Docs.docx docs/downloads/OTCv8-Docs.epub docs/downloads/site.zip
+
+          # sanity: upewnij się, że nie ma zmian w .github/workflows
+          if ! git diff --cached --name-only | grep -v '^.github/workflows/' >/dev/null; then
+            echo "OK: brak zmian w workflowach"
+          fi
+
+          git commit -m "export: DOCX/EPUB/ZIP" || echo "no changes"
+          git push

.github/workflows/fix-md.yml

@@ -0,0 +1,26 @@
+name: Fix Markdown (manual)
+on:
+  workflow_dispatch: {}
+permissions: { contents: write }
+
+jobs:
+  fix:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 0 }
+      - uses: actions/setup-node@v4
+        with: { node-version: '20' }
+      - run: npm install prettier markdownlint-cli@0 glob@10 --no-save
+      - run: node scripts/fix-md.mjs
+      - run: npx prettier --write "docs/**/*.md"
+      - run: npx markdownlint --fix "docs/**/*.md" || true
+      - name: Commit fixes
+        run: |
+          git config user.name "github-actions"
+          git config user.email "actions@github.com"
+          git add -A
+          git restore --staged docs/build || true
+          git restore --staged site || true
+          git commit -m "chore(md): auto-fix formatting" || echo "no changes"
+          git push

.github/workflows/pages-cleanup.yml

@@ -0,0 +1,88 @@
+name: Cleanup GitHub Pages queue
+on:
+  workflow_dispatch: {}
+
+permissions:
+  actions: write
+  contents: read
+  pages: write
+
+jobs:
+  cleanup:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Cancel queued/in_progress runs of Pages workflow
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const { owner, repo } = context.repo?.owner ? context.repo : (() => {
+              const [o,r] = (process.env.GITHUB_REPOSITORY||'').split('/');
+              return { owner:o, repo:r };
+            })();
+            if (!owner || !repo) core.setFailed('owner/repo undefined');
+
+            // znajdź workflow zawierający pages deploy (zmień jeśli używasz innej nazwy)
+            const workflows = await github.paginate(github.rest.actions.listRepoWorkflows, { owner, repo, per_page:100 });
+            const pagesWf = workflows.find(w =>
+              w.path.endsWith('/pages.yml') ||
+              /deploy.*pages/i.test(w.name||'') ||
+              /pages/i.test(w.name||'')
+            );
+            if (!pagesWf) {
+              core.notice('Nie znaleziono workflowu Pages (pages.yml) – pomijam runs.');
+            } else {
+              for (const status of ['queued','in_progress']) {
+                for await (const resp of github.paginate.iterator(
+                  github.rest.actions.listWorkflowRuns,
+                  { owner, repo, workflow_id: pagesWf.id, status, per_page: 100 }
+                )) {
+                  const runs = resp.data?.workflow_runs || [];
+                  for (const run of runs) {
+                    core.info(`Cancel run ${run.id} (${status})`);
+                    await github.rest.actions.cancelWorkflowRun({ owner, repo, run_id: run.id });
+                    await new Promise(r => setTimeout(r, 150));
+                  }
+                }
+              }
+              // usuń zakończone runy tego samego workflowu
+              for await (const resp of github.paginate.iterator(
+                github.rest.actions.listWorkflowRuns,
+                { owner, repo, workflow_id: pagesWf.id, status: 'completed', per_page: 100 }
+              )) {
+                const runs = resp.data?.workflow_runs || [];
+                for (const run of runs) {
+                  core.info(`Delete completed run ${run.id}`);
+                  await github.rest.actions.deleteWorkflowRun({ owner, repo, run_id: run.id });
+                  await new Promise(r => setTimeout(r, 100));
+                }
+              }
+            }
+
+      - name: Cancel active GitHub Pages deployments
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const { owner, repo } = context.repo?.owner ? context.repo : (() => {
+              const [o,r] = (process.env.GITHUB_REPOSITORY||'').split('/');
+              return { owner:o, repo:r };
+            })();
+            if (!owner || !repo) core.setFailed('owner/repo undefined');
+
+            // API Pages deployments (wymaga pages:write)
+            for await (const resp of github.paginate.iterator(
+              github.request, 'GET /repos/{owner}/{repo}/pages/deployments',
+              { owner, repo, per_page: 100 }
+            )) {
+              const list = Array.isArray(resp.data) ? resp.data : (resp.data?.deployments || []);
+              for (const d of list) {
+                try {
+                  core.info(`Cancel Pages deployment ${d.id} (${d.status})`);
+                  await github.request('POST /repos/{owner}/{repo}/pages/deployments/{deployment_id}/cancel', {
+                    owner, repo, deployment_id: d.id
+                  });
+                  await new Promise(r => setTimeout(r, 150));
+                } catch (e) {
+                  core.warning(`Cancel failed ${d?.id}: ${e.message}`);
+                }
+              }
+            }