diff --git a/DEPLOYMENT_PLAN.md b/DEPLOYMENT_PLAN.md index 8a1a810..cbb6def 100644 --- a/DEPLOYMENT_PLAN.md +++ b/DEPLOYMENT_PLAN.md @@ -1,16 +1,16 @@ -# Future Cloudflare Pages deployment — not authorized +# Cloudflare Pages integration and maintenance plan -The independent [public source repository](https://github.com/Alexisvop/Oracle-Performance-Analyzer) has been published. No Cloudflare project, domain, deployment credential or website deployment has been created. Website deployment requires separate review and explicit owner approval; this plan does not authorize it. PUBLIC_REPOSITORY.json records the completed source publication. The original private development repository must remain private. +The independent [public source repository](https://github.com/Alexisvop/Oracle-Performance-Analyzer) has been published. The owner reports an existing [Cloudflare Pages portfolio](https://oracle-performance-analyzer.pages.dev/). Automated requests returned HTTP 403; the deployed revision and account settings are NOT VERIFIED. No Cloudflare settings, credentials or deployments are changed by this integration review. PUBLIC_REPOSITORY.json records the completed source publication. The original private development repository must remain private. ## Prepared static configuration | Setting | Proposed value | | --- | --- | -| Root directory | Repository root / blank | -| Build command | npm --prefix portfolio ci && npm --prefix portfolio run build | -| Output directory | portfolio/dist | +| Root directory | portfolio | +| Build command | npm run build | +| Output directory | dist (relative to portfolio) | | NODE_VERSION | 26.12.0, matching local validation | -| SKIP_DEPENDENCY_INSTALL | 1, for the explicit locked frontend installation | +| Dependency installation | Automatic npm installation using portfolio/package-lock.json; scripts disabled by portfolio/.npmrc | | Vite base | / | | Routing | Existing hash anchors; one EN/ES document; no history-router rewrite | | Credentials/backend | None; no Oracle connection, Functions, server or private repository input | @@ -19,9 +19,9 @@ The whole public checkout is a build input because curated evidence and reviewed ## Manual publication gate -Prefer an independently approved static-artifact upload for a future first release; it does not require automatic Git integration. No upload command is authorized by this document. If Git integration is later chosen, restrict app access to the approved public repository and explicitly review production/preview branch controls before connecting or saving a configuration. Cloudflare defaults can trigger builds/deployments on commits; automatic production and preview publication must remain disabled unless separately approved. +The current preparation targets GitHub integration for the independent public repository. The earlier direct-upload preference is superseded by this reviewed proposal; the earlier preparation performed no integration or upload. The existing hosting state is owner-reported; it is not evidence that this candidate branch has been deployed. See the [GitHub deployment runbook](docs/cloudflare-pages-deployment.md) for exact settings, authorization boundaries, validation and rollback. Restrict app access to the approved public repository. Cloudflare defaults can trigger production and preview publication; connecting the account, creating a project and choosing Save and Deploy require separate owner authorization. -The public GitHub Actions workflow performs offline checks only and its [initial hosted run](https://github.com/Alexisvop/Oracle-Performance-Analyzer/actions/runs/39892553663) passed. It has no deployment job or cloud credential. The export did not include the original private Pages workflow. No Cloudflare login, hosting integration, domain configuration, Cloudflare build or website deployment has been performed. +The public GitHub Actions workflow performs offline checks only and its [initial hosted run](https://github.com/Alexisvop/Oracle-Performance-Analyzer/actions/runs/39892553663) passed. It has no deployment job or cloud credential. The export did not include the original private Pages workflow. The prior local preparation performed no Cloudflare operation. This final review reads public URLs only and does not change hosting settings or deploy. ## Local verification and preview @@ -37,6 +37,6 @@ npm --prefix portfolio run preview The production preview binds to loopback. Browser tests use npm run test:browser from portfolio/. A compatible local Chrome may be selected with PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH; otherwise install Playwright Chromium. Source/evidence navigation continues to use reviewed same-origin assets, and the [public repository](https://github.com/Alexisvop/Oracle-Performance-Analyzer) is available independently. -Before any future approved deployment, verify the exact reviewed hashes, data, notices, EN/ES, keyboard navigation, mobile charts, source references, console and static output. Recheck the actual HTTPS origin after deployment; no hosted URL is verified now. +Before any future approved deployment, verify the exact reviewed hashes, data, notices, EN/ES, keyboard navigation, mobile charts, source references, console and static output. Recheck the actual HTTPS origin after deployment; the owner-supplied HTTPS URLs currently return HTTP 403 to automated requests, so hosted acceptance is NOT VERIFIED. Official configuration references: [Cloudflare build settings](https://developers.cloudflare.com/pages/configuration/build-configuration/), [Node and install controls](https://developers.cloudflare.com/pages/configuration/build-image/), [branch deployment controls](https://developers.cloudflare.com/pages/configuration/branch-build-controls/). diff --git a/PUBLIC_REPOSITORY.json b/PUBLIC_REPOSITORY.json index 69130c0..0d9799f 100644 --- a/PUBLIC_REPOSITORY.json +++ b/PUBLIC_REPOSITORY.json @@ -1,10 +1,12 @@ { "url": "https://github.com/Alexisvop/Oracle-Performance-Analyzer", "proposed_name": "Oracle-Performance-Analyzer", - "status": "Public repository published; initial publication authorization consumed; website deployment pending", + "status": "Public source published; website reported published by owner; final branch integration pending", "publication_authorized": true, "portfolio_source_mode": "reviewed same-origin static assets", "name_check": "Public repository existence and PUBLIC visibility verified; the earlier 404 was a historical pre-publication availability check.", - "website_deployed": false, - "deployment_authorized": false + "website_deployed": true, + "deployment_authorized": false, + "website_url": "https://oracle-performance-analyzer.pages.dev/", + "website_verification": "Owner-reported publication; automated HTTPS requests returned HTTP 403; deployed revision and Cloudflare settings NOT VERIFIED" } diff --git a/README.md b/README.md index 4dccbdc..e5f6ecd 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ A reproducible database performance engineering laboratory with a bilingual React portfolio. -**Published public source edition:** [Oracle-Performance-Analyzer](https://github.com/Alexisvop/Oracle-Performance-Analyzer) is an independent, sanitized codebase licensed under MIT. It includes reviewed historical evidence and explicitly labeled public derivatives with verifiable SHA-256 provenance. Private development history, personal context, credentials and host diagnostics are excluded. **The portfolio runs locally; no website has been deployed.** See [provenance](docs/provenance.md), [MIT license](LICENSE) and [third-party notices](THIRD_PARTY_NOTICES.md). +**Published public source edition:** [Oracle-Performance-Analyzer](https://github.com/Alexisvop/Oracle-Performance-Analyzer) is an independent, sanitized codebase licensed under MIT. It includes reviewed historical evidence and explicitly labeled public derivatives with verifiable SHA-256 provenance. Private development history, personal context, credentials and host diagnostics are excluded. **Public portfolio:** [oracle-performance-analyzer.pages.dev](https://oracle-performance-analyzer.pages.dev/), reported published by the owner. Automated hosted verification currently receives HTTP 403; this branch has not been verified as the deployed revision. Local reproduction remains available. See [provenance](docs/provenance.md), [MIT license](LICENSE) and [third-party notices](THIRD_PARTY_NOTICES.md). > OSPA is an independent educational and engineering project. It is not an official Oracle product and is not affiliated with or certified by Oracle Corporation. It does not replace Oracle Real Application Testing, SQL Performance Analyzer or SQL Tuning Advisor. @@ -43,7 +43,7 @@ npm --prefix portfolio run build npm --prefix portfolio run dev ~~~ -Open the loopback URL printed by Vite. English is the default; EN/ES switches the same document. Vite base is / for future root-hosted Cloudflare Pages. The site serves reviewed local evidence/documentation/source references; it does not link to the private repository. The [public repository](https://github.com/Alexisvop/Oracle-Performance-Analyzer) is available; Cloudflare Pages and GitHub Pages have not been deployed. [Frontend guide](portfolio/README.md). +Open the loopback URL printed by Vite. English is the default; EN/ES switches the same document. Vite base is / for future root-hosted Cloudflare Pages. The site serves reviewed local evidence/documentation/source references; it does not link to the private repository. The [public repository](https://github.com/Alexisvop/Oracle-Performance-Analyzer) is available; the owner has supplied the Cloudflare Pages URL above. GitHub Pages is not used. [Frontend guide](portfolio/README.md). ## Results and interpretation diff --git a/docs/cloudflare-pages-deployment.md b/docs/cloudflare-pages-deployment.md new file mode 100644 index 0000000..8fd6f8f --- /dev/null +++ b/docs/cloudflare-pages-deployment.md @@ -0,0 +1,117 @@ +# Cloudflare Pages with GitHub — integration and operations runbook + +This runbook targets only [Alexisvop/Oracle-Performance-Analyzer](https://github.com/Alexisvop/Oracle-Performance-Analyzer). The owner reports an existing deployment at https://oracle-performance-analyzer.pages.dev/ and the version URL https://8838874e.oracle-performance-analyzer.pages.dev/. Automated HTTPS requests to both returned HTTP 403; the live revision and account settings are NOT VERIFIED. The earlier local preparation performed no hosting operation, and this final task changes no Cloudflare setting or credential. Obtain independent technical review and explicit owner authorization before performing the remote steps below. Creating the Git integration and selecting Save and Deploy can publish immediately; do not treat setup as an offline operation. + +## Exact configuration + +| Setting | Value | +| --- | --- | +| Git provider / repository | GitHub / Alexisvop/Oracle-Performance-Analyzer | +| Production branch | main | +| Framework preset | Vite / React (Vite), according to dashboard label | +| Root directory | portfolio | +| Build command | npm run build | +| Build output directory | dist | +| Build image | v3 | +| NODE_VERSION | 26.12.0 | +| Dependency install | Enabled; npm with committed package-lock.json | +| SKIP_DEPENDENCY_INSTALL | Unset; do not carry over the old value 1 | +| Dependency lifecycle scripts | Disabled by portfolio/.npmrc | +| Preview branches | None unless separately authorized | +| Automatic production deployments | Disabled after initial setup unless explicitly authorized | +| Functions, secrets, bindings, analytics, custom domain | None | + +The Node version file is portfolio/.node-version; set NODE_VERSION identically in the dashboard. The broad package.json engines range is not the runtime pin. Cloudflare starts install/build from portfolio, but the complete public checkout is required: evidence, SQL, source and documentation outside that folder are build inputs. Deploy only dist from inside portfolio. Do not upload the repository root or set output to `..`. + +Cloudflare manages dependency installation before the build command. Verify in the first authorized hosted build that it uses the committed npm lock and does not mutate versions or execute install scripts. If the platform changes package-manager behavior, stop and review the log; do not silently switch to unpinned installation. Local validation uses npm ci; hosted installer equivalence is not yet verified. The native optional packages used by Vite work locally with lifecycle scripts disabled. + +Official references: [build settings](https://developers.cloudflare.com/pages/configuration/build-configuration/) and [runtime overrides](https://developers.cloudflare.com/pages/configuration/build-image/). + +## Local verification before authorization + +From portfolio, using Node 26.12.0 and existing locked dependencies: + +```sh +node --version +npm ci +npm run data:check +npm run typecheck +npm run lint +npm test +npm run build +npm run test:browser +``` + +A compatible installed Chromium may be supplied using PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH. No browser installation or Oracle service is needed in Cloudflare: browser tests belong to the local/CI verification gate, not the production build. npm run build validates the data, typechecks, builds with Vite, then audits dist. Run npm run audit:dist again to print the sorted SHA-256 inventory. Build twice and compare all paths and digests; preserve the inventories outside dist. + +The output audit compares approved source assets, evidence and notices with their current public inputs. It rejects unexpected files, symlinks, altered reference assets and common secret/private-path/tracker patterns. Its pattern scan cannot establish absolute absence of all confidential strings; manually review the source allowlist as well. Do not expand portfolio/public-source-files.json to include interview preparation, prompts, internal audits or private operational records. A directory's presence in a public checkout does not authorize adding it to the website. + +Historical EXPORT_MANIFEST.json and its checksum remain an immutable initial-export snapshot; do not regenerate them for frontend changes. Verify their own checksum and all evidence provenance hashes. Current deployment artifacts have a separate local sorted hash inventory from audit:dist. + +## Initial connection procedure — only if not already connected + +Do not repeat initial project creation on an existing integration. First inspect the existing project read-only in the dashboard; account-specific access and settings are not available to this audit. The following initial-setup steps are retained for an owner-authorized setup only. + +1. Review the exact public commit to deploy and its passing GitHub Actions checks. Confirm main contains the approved frontend changes; uncommitted local work cannot be deployed from GitHub. +2. In Cloudflare Workers & Pages select Create application, then Pages, then Connect to Git. Use the Pages static-site flow, not a Workers deployment. Choose GitHub and the Alexisvop account. +3. Review the Cloudflare Workers & Pages GitHub App permissions. Choose Only select repositories and grant access solely to Oracle-Performance-Analyzer. Never choose all repositories or the original private project. If narrower access is unavailable, stop for review. +4. Select the exact repository and enter the configuration table above. Keep the project name/hostname as an owner decision; no pages.dev URL or domain is reserved by this document. Inspect all variables: only the non-secret runtime pin is needed. Do not add Oracle credentials, API tokens or VITE_* secrets. +5. Stop before Save and Deploy unless authorization specifically covers the first public deployment. There is no verified promise that project creation is a non-publishing draft mode. +6. After an authorized first deployment, open Settings > Builds & deployments / Branch control. Set production branch main, disable automatic production deployments and set preview branches to None unless the owner expressly approved those automation scopes. Save and verify the controls before further pushes or pull requests. If setup exposes these controls before the first deployment, set them there too. Avoid pushes during initial setup. + +The GitHub App connection itself is not performed during this task. Cloudflare defaults can deploy both production and preview changes. Source: [Git setup](https://developers.cloudflare.com/pages/get-started/git-integration/), [GitHub access scope](https://developers.cloudflare.com/pages/configuration/git-integration/github-integration/), [branch controls](https://developers.cloudflare.com/pages/configuration/branch-build-controls/). + +## Routing and hosted acceptance + +Vite base is `/`. This application uses section hashes on one document; it has no history router or separate EN/ES paths. Do not invent /en, /es, /results or a catch-all rewrite. Direct root bookmarks such as /#results must work after refresh. EN/ES changes the current document and html lang; a fresh page defaults to English. Source pages use explicit /source/... paths, and evidence uses /data/evidence.json. + +After a separately authorized deployment: + +- Record the deployment ID, commit, build log, Node version and actual HTTPS URL. Confirm the selected project is Pages and the output was dist only. +- Open `/`, `/#results`, `/#docs`, `/source/index.html`, `/source/README.md.html` and `/data/evidence.json` directly and after refresh. Cloudflare can canonicalize .html URLs; verify redirects preserve the correct page and fragment. Do not count an HTML fallback response as valid JSON or a JavaScript asset. +- Check English default, EN/ES switching, keyboard menu/skip link, charts/tables and desktop/tablet/mobile layouts. Inspect console/network for errors and unapproved third-party requests. +- Verify the public GitHub link, approved source/evidence links and all six license notices. Confirm deferred Group C and Engineering Challenges remain labeled future work. +- Compare published asset bytes with the approved local inventory, including decoded response bodies if HTTP compression is used. Confirm no additional tracker/analytics script was injected by platform settings. +- Keep preview publication and automatic production triggers disabled until separately authorized. A successful local test is not a hosted acceptance result. + +No _redirects, Functions, Wrangler deployment config, GitHub deployment workflow or hosting token is required for this static hash-navigation site. + +## Disable automation, rollback and exposure response + +These are owner-operated incident procedures after deployment authorization, not actions performed now. + +1. Freeze automation: in the project's branch controls uncheck Enable automatic production branch deployments and set preview branches to None; save. Cancel any queued/running deployment where available. Disabling builds does not remove an already published site or existing preview URLs. +2. For a regression with a known safe production version, go to Deployments > All deployments, select the safe successful production deployment's three-dot menu, then Rollback to this deployment and confirm. Preview deployments are not eligible rollback targets. Record the target ID/commit and retest the live URL. Leave automatic deployments disabled to prevent the next push from replacing the rollback. [Official rollback procedure](https://developers.cloudflare.com/pages/configuration/rollbacks/). +3. Rollback does not erase retained deployment-specific URLs. If confidential material was exposed, keep logs/IDs without reproducing the secret, notify the owner and rotate any affected credentials through their authorized issuer. Obtain explicit approval to remove affected deployment artifacts/URLs. Do not assume rollback or removing a custom domain eliminates pages.dev access. +4. If there is no safe prior deployment or full takedown is required, obtain explicit owner authorization for project/deployment removal. Follow the [official project-removal procedure](https://developers.cloudflare.com/pages/get-started/git-integration/); review custom-domain DNS cleanup first if any domain was later attached. Deletion is destructive and is not authorized by this runbook. +5. Correct the source through an independently reviewed public PR, rerun local/CI checks and obtain approval for redeployment. Re-enable automation only under its own approved scope. Do not rewrite Git history to respond to a hosting regression. + +## Current readiness + +The candidate is being prepared for PR review; the owner reports an existing public site. Cloudflare's hosted installer, account permissions, selected hostname, redirects and live rollback remain NOT VERIFIED until a separately authorized remote operation. No interview material, original private repository input, Oracle connection or tracking service is required by this design. + +## Historical local preparation validation record + +Base: public main commit 2d920f16184a24965911a4a0cb9b281c4b58baee; working branch feature/cloudflare-pages. Main includes the approved post-publication documentation maintenance. The source allowlist, measurements, historical evidence, MIT license and third-party notices are unchanged. + +Validation used Node 26.12.0 and npm 12.2.1. These results describe the earlier preparation, not a fresh final run. Final-run results are recorded in docs/final-production-readiness.md. The exact Node runtime was obtained from nodejs.org, checked against its official SHASUMS256.txt, and isolated locally without changing the system runtime. The linux-x64 archive SHA-256 was fd47865ecd6391ebb431fc815e01b9135bf83ded5cf373247e9331e196b7aded. This is an official-source integrity check, not an independent attestation of the toolchain. + +| Check | Result | Exit code | +| --- | --- | ---: | +| npm ci | Lockfile installation; lifecycle scripts disabled; zero vulnerabilities reported by npm | 0 | +| npm run data:check | 44 input hashes, 23 measurements, eight same-result comparisons | 0 | +| npm run typecheck | PASS | 0 | +| npm run lint | PASS | 0 | +| npm test | 14 tests passed | 0 | +| npm run build, twice | Both builds and output audits passed; 139 byte-identical assets | 0 | +| npm run test:browser | 18 scenarios passed across desktop, tablet and mobile; EN/ES, keyboard, links and axe assertions passed | 0 | +| Independent output negative checks | Private extra file, altered evidence, synthetic token, tracker and symlink all rejected | 0 | +| Generated HTML references | 359 local links/assets/fragments resolved | 0 | +| Historical integrity | Manifest checksum and 61 public provenance hashes matched | 0 | +| Markdown audit | 187 repository links checked; 30 external URLs classified | 0 | +| Offline Python unit tests | 198 tests and 55 subtests passed | 0 | +| git diff --check | No whitespace errors | 0 | + +Sorted path-to-SHA256 inventory digest: 88e93d0928afd8ba8b3ba45264b3943f907e90b8e4873fffd93f1bdf413d7194, calculated over Python json.dumps(inventory, sort_keys=True). The inventory and command/exit-code logs are local-only under .cache/docs-cleanup. They are outside dist and excluded from Git. + +The Markdown auditor explicitly adds this new guide to its reviewed paths; it does not rewrite EXPORT_MANIFEST.json or relax missing-file, traversal, symlink or generated-output checks. Final link audit, offline Python tests and whitespace checks are recorded in the local review results. No hosting credential or Oracle connection was used. Hosted verification and account-specific rollback remain pending owner authorization. diff --git a/docs/final-production-readiness.md b/docs/final-production-readiness.md new file mode 100644 index 0000000..a26409b --- /dev/null +++ b/docs/final-production-readiness.md @@ -0,0 +1,104 @@ +# Final production readiness — pre-merge integration report + +## Executive status + +OSPA Public Edition is a reproducible synthetic SQL performance laboratory with an offline Python report path and a bilingual static portfolio. The final local integration candidate passes its verification gates. The project is **not closed**: the owner must review and merge the PR, then verify the corresponding stable Cloudflare deployment. This report is a pre-push snapshot; later remote CI observations belong to the PR checks and final review record. + +Repository: [Alexisvop/Oracle-Performance-Analyzer](https://github.com/Alexisvop/Oracle-Performance-Analyzer). Branch: feature/cloudflare-pages. Inspected public main/base: 2d920f16184a24965911a4a0cb9b281c4b58baee, including approved documentation cleanup. No pre-existing feature commits, conflicts or unrelated untracked files were included. Only the explicitly reviewed files below are intended for the commit. The private repository was not consulted. No Oracle connection, DDL, DML, DBMS_STATS or container operation occurred. + +## Exact scope + +- portfolio/.node-version and portfolio/.npmrc: pin Node and disable install lifecycle scripts. +- portfolio/package.json and portfolio/scripts/audit-dist.ts: enforce static-output auditing after the build. +- portfolio/src/data/deployment.test.ts and portfolio/tests/public-source.spec.ts: filesystem-boundary and public-source URL checks. +- portfolio/README.md, DEPLOYMENT_PLAN.md and [deployment runbook](cloudflare-pages-deployment.md): build settings, GitHub access scope, branch controls, validation and rollback. +- README.md, PUBLIC_REPOSITORY.json, portfolio/src/i18n.ts and portfolio/scripts/public-assets.ts: remove obsolete unpublished-site statements, preserve EN/ES, and distinguish owner-reported hosting from automated verification. deployment_authorized remains false: this task authorizes no Cloudflare configuration change or manual deployment. +- scripts/check_documentation_links.py: explicitly review the two new operational documents without rewriting the historical manifest or relaxing path checks. +- docs/final-production-readiness.md: this integration report. + +Total: 15 files. No Python application, SQL, benchmark measurements, historical evidence, source asset allowlist, dependency lockfile, MIT license or third-party notices changed. No interview-preparation documents, original Git history, credentials or generated outputs are included. No dependency or tracker was added. + +## Local checks and actual exit codes + +Python 3.14 environment; Node 26.12.0; npm 12.2.1. Oracle environment variables were removed by the local verification launcher. Commands run from repository root unless marked portfolio. + +| Command/check | Result | Exit | +| --- | --- | ---: | +| .venv/bin/python -m pip check | Dependency consistency PASS | 0 | +| .venv/bin/python -m compileall -q src scripts tests | Compilation PASS | 0 | +| .venv/bin/python -B scripts/check_documentation_links.py | Public Markdown paths and fragments PASS | 0 | +| .venv/bin/python -m pytest -q tests/unit | 198 tests and 55 subtests passed | 0 | +| .venv/bin/python -m oracle_spa.cli report-all --output results/final-closure/first | Offline report generated | 0 | +| Same command with results/final-closure/second | Independent second bundle generated | 0 | +| .venv/bin/python scripts/verify_public_reports.py results/final-closure/first results/final-closure/second | 40 input hashes and 12 output hashes; byte-identical bundles | 0 | +| npm ci (portfolio) | Locked dependency installation PASS | 0 | +| npm audit --audit-level=high --json (portfolio) | No advisories reported, including development dependencies | 0 | +| npm run data:check (portfolio) | 44 input hashes, 23 measurements, eight same-result comparisons | 0 | +| npm run typecheck (portfolio) | PASS | 0 | +| npm run lint (portfolio) | PASS | 0 | +| npm test (portfolio) | 14 tests passed | 0 | +| npm run build twice (portfolio) | Audit passed twice; 139 byte-identical assets | 0 | +| npm run test:browser (portfolio) | 18 scenarios passed; 36 axe analyses; desktop/tablet/mobile, EN/ES and navigation | 0 | +| Pattern scan and protected-file/license verification | PASS within stated scope | 0 | +| OSV querybatch for requirements.lock | No matched advisories for 22 exact PyPI versions | 0 | +| git diff --check | PASS | 0 | + +Current static inventory digest: 193d02e5bf9761cde3cc5838262279ac01e2f465bf374eae137257f8881ef65c, SHA-256 of Python json.dumps(sorted path-to-digest mapping, sort_keys=True). This identifies the current candidate output; it does not replace historical evidence hashes. Local full command logs with exit codes and log hashes are ignored under .cache/docs-cleanup; final security, public HTTP and inventory records are ignored under .cache/final-closure. No audit cache or generated report is deployed or committed. + +## Integrity, secrets and licensing + +The initial export manifest's detached checksum passes. Sixty-one public provenance hashes match. All 110 protected public files selected for evidence/application/SQL/license/lock verification are byte-identical to public main. The six redistributed license files match the SHA-256 entries in THIRD_PARTY_NOTICES.md. LICENSE retains Copyright (c) 2026 Alexis Abraham Perez Olvera; third-party grants remain distinct. + +Public tracked files and exact new candidate paths were scanned for private-key headers, common provider tokens, credential-bearing URLs, private-origin links and personal absolute paths; no matches were found. Dist auditing additionally requires its exact expected file inventory and public-source bytes, rejects symlinks and checks common secret/tracker patterns. Browser tests cover notices and source links. Five earlier negative production-output fixtures established rejection of an extra private file, altered evidence, synthetic token, tracker and symlink; the final production auditor and unit boundary tests passed again. + +This is a scoped pattern scan and manual review, not a guarantee of detecting every credential form. Gitleaks was unavailable and was not claimed as executed. Vulnerability databases are time-dependent and may miss undisclosed issues; no critical/high finding was identified by the npm/OSV queries in this scope. No credential, wallet, Oracle file or private prompt was used. + +## Engineering and recruiter presentation + +The README and portfolio explain the problem, architecture, technologies, synthetic dataset, methodology, favorable and unfavorable observations, offline reproduction, limitations and future work. Eight queries/ten variants exist; benchmark coverage is not asserted for Q03–Q05. The 42,500 business rows exclude the metadata row. E01 and E02 favorable percentages remain tied to unrounded client-latency medians; E03 range remains unfavorable despite index selection. Same-cohort E04 comparisons preserve PAID/CANCELLED distinctions. + +EXPLAIN PLAN estimates are not runtime A-Rows/Buffers/Starts; cost is not milliseconds. Sequential descriptive blocks do not prove causality or universal speedups. Group C privileged cursor metrics, bind peeking, advanced diagnostics, multi-scale experiments and Engineering Challenges remain deferred. No business adoption, employment, Oracle endorsement or production performance result is claimed. EN/ES remains one accessible document. + +## Cloudflare compatibility and remote status + +| Setting | Candidate value | +| --- | --- | +| Framework | React / Vite | +| Root directory | portfolio | +| Build command | npm run build | +| Output directory | dist | +| Production branch | main | +| Node | 26.12.0 | +| Vite base | / | + +The full public checkout remains a build input; only portfolio/dist is uploaded. The build uses no backend, Oracle, secrets, Functions or private input. Existing hash navigation and explicit static source paths are locally verified. No hosting setting or credential was changed. + +The owner supplied [stable portfolio](https://oracle-performance-analyzer.pages.dev/) and [prior deployment](https://8838874e.oracle-performance-analyzer.pages.dev/). Read-only HTTPS requests to root, /data/evidence.json and /source/index.html on both origins returned HTTP 403. **Remote content, live commit, account build settings, redirects, installed Node and runtime behavior are NOT VERIFIED.** A 403 does not establish its cause or imply the application is broken. No mitigation or hosting configuration change was attempted. + +The owner reports that merging main triggers Cloudflare deployment. This audit cannot confirm account settings or preview automation; a branch push/PR may also trigger an existing preview integration. No deployment is manually initiated. Before merge the owner must verify the main/preview controls and exact build parameters in the existing project. Do not recreate or reconnect an existing project. + +## GitHub Actions and acceptance + +Workflow reviewed: OSPA Public Edition Offline CI. Permissions are contents: read; upstream actions are SHA-pinned. Jobs cover Python offline dependencies/CLI/tests/report determinism and frontend data/types/lint/tests/build/browser checks. There is no Oracle service, production credential or deployment job. + +At report authoring, CI for the new commit is PENDING because the branch has not yet been pushed. After publication, the exact commit's PR checks and final review record are authoritative; do not interpret older green runs as this commit passing. [Branch workflow runs](https://github.com/Alexisvop/Oracle-Performance-Analyzer/actions?query=branch%3Afeature%2Fcloudflare-pages). + +| Acceptance item | State at this pre-push snapshot | +| --- | --- | +| Local Python/frontend checks and deterministic artifacts | PASS | +| Evidence, license and public-source isolation | PASS | +| Critical/high vulnerabilities found in queried scope | None | +| PR exists and latest remote CI passed | PENDING publication and remote verification | +| Stable Cloudflare content and deployment commit | NOT VERIFIED: HTTP 403 | +| Merge or manual deployment executed | NO | +| Project formally closed | NO | + +## Merge recommendation and owner checklist + +GO for controlled feature-branch publication and independent PR review. Final merge recommendation is conditional on green checks for the exact PR head and owner verification of the existing Cloudflare project. Do not merge solely on this pre-push report. Current verdict: PASS LOCAL — REMOTE VERIFICATION PENDING. + +Before merge, inspect the 15-file diff, confirm CI green on the final head, confirm no unexpected file or history enters main, and inspect the existing Cloudflare project read-only for main, portfolio, npm run build, dist, Node 26.12.0 and branch controls. Resolve or explain the external HTTP 403 from an authorized browser; verify EN/ES, direct source/evidence links, responsive views and notices. + +After an owner-authorized merge, record the new main SHA and Cloudflare deployment ID/log/result. Confirm the stable hostname serves that deployment, not only a version URL. Recheck root/hash bookmarks, static JS/CSS, JSON content types and source links, EN/ES, keyboard/mobile behavior, console and no injected analytics. Use the reviewed runbook to freeze automation or roll back if needed; rollback alone does not remove retained deployment URLs. Close the project only after that evidence exists. + +Future work and residual limits: privileged runtime metrics and broader-scale methodology remain deferred; hosted installer equivalence and account-specific rollback are not tested here. A later reviewed change can strengthen secret scanning and dependency attestations without altering historical measurements. diff --git a/portfolio/.node-version b/portfolio/.node-version new file mode 100644 index 0000000..2b42e39 --- /dev/null +++ b/portfolio/.node-version @@ -0,0 +1 @@ +26.12.0 diff --git a/portfolio/.npmrc b/portfolio/.npmrc new file mode 100644 index 0000000..97b895e --- /dev/null +++ b/portfolio/.npmrc @@ -0,0 +1 @@ +ignore-scripts=true diff --git a/portfolio/README.md b/portfolio/README.md index 9b2cbe8..a4e76a0 100644 --- a/portfolio/README.md +++ b/portfolio/README.md @@ -15,8 +15,14 @@ npm run dev Use Node 26.12.0 for the locally validated environment. Playwright uses its Chromium installation or PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH=/usr/bin/google-chrome-stable when available. Unit and browser tests cover numbers/data hashes, EN/ES, local references, keyboard controls, charts, layouts and axe accessibility checks. -The root Vite base / is suitable for a future Cloudflare origin-root deployment. The production directory is portfolio/dist. A strict source asset list emits only reviewed code, documentation/evidence and third-party notices as local static references; no private URL is required. The [public source repository](https://github.com/Alexisvop/Oracle-Performance-Analyzer) is available. The portfolio currently runs locally; Cloudflare Pages has not been deployed; deployment still requires separate owner authorization. No automatic deployment workflow exists. +The root Vite base / is suitable for a future Cloudflare origin-root deployment. The production directory is portfolio/dist. A strict source asset list emits only reviewed code, documentation/evidence and third-party notices as local static references; no private URL is required. The [public source repository](https://github.com/Alexisvop/Oracle-Performance-Analyzer) is available. The owner reports the [Cloudflare Pages portfolio](https://oracle-performance-analyzer.pages.dev/) as published. Automated hosted requests returned HTTP 403, so the live revision and account settings remain NOT VERIFIED. Local preview remains available. Git integration may deploy automatically; no GitHub Actions deployment job exists. This task changes no Cloudflare settings. The evidence exporter checks 44 input hashes, 23 measurements and eight equivalent-result comparisons. Forty public inputs also regenerate the independent Python report bundle. Inputs are committed public source, not ignored results. Historical 180/55 test counts remain labeled historical; the [initial public CI run](https://github.com/Alexisvop/Oracle-Performance-Analyzer/actions/runs/39892553663) records the release verification. [Project README](../README.md), [architecture](../docs/architecture.md), [evidence](../docs/evidence/README.md), [notices](../THIRD_PARTY_NOTICES.md), [security](../docs/security.md). + +## Prepared Cloudflare Pages settings + +Root directory: portfolio; framework: Vite (React); production branch: main; build command: npm run build; output: dist; NODE_VERSION: 26.12.0. The .node-version file pins that runtime and .npmrc disables dependency lifecycle scripts. Keep Cloudflare's automatic dependency installation enabled and use the committed package-lock.json. Local verification uses npm ci. + +The build ends with npm run audit:dist: it verifies the exact output inventory, approved public source bytes, notices and common secret/private-path patterns. It rejects symlinks, unapproved extra files and interview materials. A successful build is local preparation, not deployment authorization. The connection, branch controls, rollback and hosted acceptance procedure is documented at docs/cloudflare-pages-deployment.md in the repository root; that operations guide is not part of the website source allowlist. diff --git a/portfolio/package.json b/portfolio/package.json index d872026..a6dcf2b 100644 --- a/portfolio/package.json +++ b/portfolio/package.json @@ -14,8 +14,9 @@ "lint": "eslint . --max-warnings 0", "test": "vitest run", "test:browser": "playwright test", - "build": "npm run data:check && npm run typecheck && vite build", - "preview": "vite preview --host 127.0.0.1" + "build": "npm run data:check && npm run typecheck && vite build && npm run audit:dist", + "preview": "vite preview --host 127.0.0.1", + "audit:dist": "node scripts/audit-dist.ts" }, "dependencies": { "lucide-react": "1.61.0", diff --git a/portfolio/scripts/audit-dist.ts b/portfolio/scripts/audit-dist.ts new file mode 100644 index 0000000..0544f24 --- /dev/null +++ b/portfolio/scripts/audit-dist.ts @@ -0,0 +1,66 @@ +import { createHash } from 'node:crypto'; +import { lstatSync, readFileSync, readdirSync } from 'node:fs'; +import { dirname, join, relative, resolve } from 'node:path'; +import { fileURLToPath } from 'node:url'; +import { publicAssets } from './public-assets.ts'; + +const portfolio = resolve(dirname(fileURLToPath(import.meta.url)), '..'); +const root = resolve(portfolio, '..'); + +/** Fail closed on unexpected output, altered public references and obvious secrets. */ +export function auditDist(directory = join(portfolio, 'dist')): Record { + const target = resolve(directory); + for (let path = target; ; path = dirname(path)) { + if (lstatSync(path).isSymbolicLink()) throw new Error('Symlink in output path'); + if (path === dirname(path)) break; + } + const files: string[] = []; + function walk(path: string) { + for (const entry of readdirSync(path)) { + const full = join(path, entry), stat = lstatSync(full); + if (stat.isSymbolicLink()) throw new Error('Symlink in output'); + if (stat.isDirectory()) walk(full); + else if (stat.isFile()) files.push(relative(target, full).split('\\').join('/')); + else throw new Error('Non-regular output file'); + } + } + walk(target); + const sources: string[] = JSON.parse(readFileSync(join(portfolio, 'public-source-files.json'), 'utf8')); + if (sources.some((path) => /(?:^|\/)(?:presentation|recursos|_private_audit)(?:\/|$)/.test(path))) + throw new Error('Unapproved document category'); + const expected = publicAssets(root, sources); + expected.set('data/evidence.json', readFileSync(join(portfolio, 'src/data/evidence.json'), 'utf8')); + expected.set('favicon.svg', readFileSync(join(portfolio, 'public/favicon.svg'), 'utf8')); + expected.set('data/bundle-packages.json', JSON.stringify({ + bundledPackages: ['lucide-react', 'react', 'react-dom', 'scheduler'], + helperNotices: ['vite', 'tailwindcss'], + }, null, 2) + '\n'); + const html = readFileSync(join(target, 'index.html'), 'utf8'); + const assets = [...html.matchAll(/(?:src|href)="(\/assets\/[A-Za-z0-9_-]+\.(?:js|css))"/g)].map((m) => m[1].slice(1)); + if (assets.length !== 2 || !assets.some((p) => p.endsWith('.js')) || !assets.some((p) => p.endsWith('.css'))) + throw new Error('Unexpected entry assets or non-root base'); + const allowed = new Set([...expected.keys(), 'index.html', ...assets]); + if (files.length !== allowed.size || files.some((path) => !allowed.has(path))) + throw new Error('Unexpected or missing output files'); + const patterns = [ + /-----BEGIN (?:RSA |EC |OPENSSH )?PRIVATE KEY-----/, + /(?:gh[pousr]_[A-Za-z0-9]{30,}|github_pat_[A-Za-z0-9_]{40,}|AKIA[A-Z0-9]{16})/, + /(?:\/home\/[^/\s]+\/|\/Users\/[^/\s]+\/|[A-Z]:\\Users\\)/, + /github\.com\/Alexisvop\/Oracle_Perf(?:o)?mance/i, + /https?:\/\/[^\s/:]+:[^\s/@]+@/, + /(?:google-analytics\.com|googletagmanager\.com|static\.cloudflareinsights\.com)/, + ]; + const hashes: Record = {}; + for (const path of files.sort()) { + const bytes = readFileSync(join(target, path)), text = bytes.toString('utf8'); + if (expected.has(path) && text !== expected.get(path)) throw new Error('Public asset mismatch: ' + path); + if (patterns.some((pattern) => pattern.test(text))) throw new Error('Sensitive or unapproved content: ' + path); + hashes[path] = createHash('sha256').update(bytes).digest('hex'); + } + return hashes; +} + +if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) { + const hashes = auditDist(); + console.log(JSON.stringify({ status: 'PASS', files: Object.keys(hashes).length, sha256: hashes }, null, 2)); +} diff --git a/portfolio/scripts/public-assets.ts b/portfolio/scripts/public-assets.ts index 23ac8a1..cc3f345 100644 --- a/portfolio/scripts/public-assets.ts +++ b/portfolio/scripts/public-assets.ts @@ -57,6 +57,6 @@ export function publicAssets(rootPath: string, files: string[]): MapOSPA · Reviewed public source

Documentation, source and synthetic evidence from this public edition. The portfolio runs locally; website deployment is pending. Public repository: Oracle-Performance-Analyzer.

Documentación, código y evidencia sintética de esta edición pública. El portafolio se ejecuta localmente; el despliegue web está pendiente. Repositorio público: Oracle-Performance-Analyzer.

')); + assets.set('source/index.html', frame('Reviewed public source', '

OSPA · Reviewed public source

Documentation, source and synthetic evidence from this public edition. Public repository: Oracle-Performance-Analyzer.

Documentación, código y evidencia sintética de esta edición pública. Repositorio público: Oracle-Performance-Analyzer.

')); return assets; } diff --git a/portfolio/src/data/deployment.test.ts b/portfolio/src/data/deployment.test.ts new file mode 100644 index 0000000..d65b21a --- /dev/null +++ b/portfolio/src/data/deployment.test.ts @@ -0,0 +1,25 @@ +import { mkdtempSync, rmSync, symlinkSync, writeFileSync } from 'node:fs'; +import { join } from 'node:path'; +import { tmpdir } from 'node:os'; +import { describe, expect, it } from 'vitest'; +import { auditDist } from '../../scripts/audit-dist.ts'; + +// The build output is created after unit tests; these fixtures exercise the +// filesystem boundary before any browser or Cloudflare service is involved. +describe('Deployment output filesystem boundary', () => { + it('refuses a symlink output root', () => { + const dir = mkdtempSync(join(tmpdir(), 'ospa-dist-')); + try { + symlinkSync(dir, join(dir, 'output')); + expect(() => auditDist(join(dir, 'output'))).toThrow('Symlink'); + } finally { rmSync(dir, { recursive: true }); } + }); + it('refuses symlinks inside output before reading their targets', () => { + const dir = mkdtempSync(join(tmpdir(), 'ospa-dist-')); + try { + writeFileSync(join(dir, 'outside'), 'synthetic fixture'); + symlinkSync(join(dir, 'outside'), join(dir, 'leak')); + expect(() => auditDist(dir)).toThrow('Symlink'); + } finally { rmSync(dir, { recursive: true }); } + }); +}); diff --git a/portfolio/src/i18n.ts b/portfolio/src/i18n.ts index 3534499..af83e53 100644 --- a/portfolio/src/i18n.ts +++ b/portfolio/src/i18n.ts @@ -138,7 +138,7 @@ const en = { historical: 'Historical verification; not a new live Oracle test.', docsTitle: 'Read the evidence. Reproduce the analysis.', repositoryAccess: - 'Reviewed documentation, source files and benchmark evidence are available locally and in the public GitHub repository. The portfolio runs locally; web deployment is pending.', + 'Reviewed documentation, source files and benchmark evidence are available here and in the public GitHub repository.', offline: '01 / Offline demonstration', offlineText: 'Run unit tests and regenerate historical reports from the repository. No Oracle, container, or credentials required.', @@ -308,7 +308,7 @@ const es: Copy = { historical: 'Verificación histórica; no es una nueva prueba Oracle en vivo.', docsTitle: 'Lee la evidencia. Reproduce el análisis.', repositoryAccess: - 'La documentación, los archivos fuente y la evidencia revisados están disponibles localmente y en el repositorio público de GitHub. El portafolio se ejecuta localmente; el despliegue web está pendiente.', + 'La documentación, los archivos fuente y la evidencia revisados están disponibles aquí y en el repositorio público de GitHub.', offline: '01 / Demostración sin Oracle', offlineText: 'Ejecuta pruebas unitarias y regenera reportes históricos desde el repositorio. Sin Oracle, contenedores ni credenciales.', diff --git a/portfolio/tests/public-source.spec.ts b/portfolio/tests/public-source.spec.ts index 656fb9c..f9d7fe6 100644 --- a/portfolio/tests/public-source.spec.ts +++ b/portfolio/tests/public-source.spec.ts @@ -13,6 +13,12 @@ test('public source pages and exact third-party notices are local, readable and await page.goto('/' + path); await expect(page.getByRole('main')).toBeVisible(); await expect(page.getByRole('heading', { level: 1 })).toHaveText(title); + if (path === 'source/index.html') { + const github = page.getByRole('link', { name: 'Oracle-Performance-Analyzer', exact: true }); + await expect(github).toHaveCount(2); + for (const link of await github.all()) + await expect(link).toHaveAttribute('href', 'https://github.com/Alexisvop/Oracle-Performance-Analyzer'); + } expect(await page.evaluate(() => document.documentElement.scrollWidth <= innerWidth)).toBe(true); expect((await new AxeBuilder({ page }).withTags(['wcag2a', 'wcag2aa', 'wcag21aa']).analyze()).violations).toEqual([]); } diff --git a/scripts/check_documentation_links.py b/scripts/check_documentation_links.py index c690221..1fcd471 100644 --- a/scripts/check_documentation_links.py +++ b/scripts/check_documentation_links.py @@ -110,7 +110,9 @@ def main(): root = args.root.resolve() manifest = json.loads((root / "EXPORT_MANIFEST.json").read_text()) approved = {row["destination_path"] for row in manifest["files"]} - approved.update({"EXPORT_MANIFEST.json", "EXPORT_MANIFEST.sha256"}) + # Reviewed guide added after the immutable initial export. + approved.update({"EXPORT_MANIFEST.json", "EXPORT_MANIFEST.sha256", + "docs/cloudflare-pages-deployment.md", "docs/final-production-readiness.md"}) print(json.dumps(audit(root, approved), indent=2))