diff --git a/AGENTS.md b/AGENTS.md index ae25fd0..4f46c6a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -7,5 +7,5 @@ Read README.md and PROJECT_SPEC.md before changes. This public edition contains - Require explicit owner approval for every database mutation, provisioning, container operation, Git publication and deployment. Historical approvals are consumed and non-reusable. - Never expose credentials, private keys, environment files or workstation identities. - Distinguish client latency, estimated plans and actual cursor metrics. Group C and Engineering Challenges remain deferred. -- Keep public-source navigation local until an actual public repository URL is approved. +- Keep reviewed source/evidence navigation available locally. PUBLIC_REPOSITORY.json records the published source URL; website deployment remains separately gated. - The _private_audit, .venv, node_modules, caches, results and release directories are local-only and must never be published. diff --git a/DEPLOYMENT_PLAN.md b/DEPLOYMENT_PLAN.md index 6942679..8a1a810 100644 --- a/DEPLOYMENT_PLAN.md +++ b/DEPLOYMENT_PLAN.md @@ -1,6 +1,6 @@ # Future Cloudflare Pages deployment — not authorized -No repository, Cloudflare project, domain, credential or deployment was created. Independent technical/security review and explicit owner approval are required before any publication. The future repository URL is pending in PUBLIC_REPOSITORY.json; its name is a proposal only. The original private development repository must remain private. +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. ## Prepared static configuration @@ -21,7 +21,7 @@ The whole public checkout is a build input because curated evidence and reviewed 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 local workflow performs checks only and has no deployment job or cloud credential. The existing private repository's GitHub Pages workflow was not changed. No Cloudflare login, GitHub App connection, domain configuration or remote builder was exercised. +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. ## Local verification and preview @@ -35,7 +35,7 @@ npm --prefix portfolio run build 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. All active project source/evidence links use reviewed same-origin assets while the external repository URL remains pending. +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. diff --git a/PUBLICATION_PLAN.md b/PUBLICATION_PLAN.md index 698e573..f403c3d 100644 --- a/PUBLICATION_PLAN.md +++ b/PUBLICATION_PLAN.md @@ -1,4 +1,12 @@ -# Proposed independent public repository — NO PUBLICATION AUTHORIZATION +# Historical independent public repository publication plan + +**Completed — do not repeat repository creation, Git initialization, the initial commit or the initial push.** The owner-authorized public release is available at [Oracle-Performance-Analyzer](https://github.com/Alexisvop/Oracle-Performance-Analyzer), on main, with independent root commit fa7237f071fcc0a6996b986835b2681e0ecc0b2e. The [initial GitHub Actions run](https://github.com/Alexisvop/Oracle-Performance-Analyzer/actions/runs/39892553663) completed successfully. Website deployment remains pending and is not authorized. + +The original pre-publication plan below is retained as historical context. Its proposed name, early 404 lookup, pending URL, authorization gates and unexecuted-command statements describe the preparation stage before publication. They are not the current publication status and confer no new authorization. The example commit message below was a proposal; the actual initial message was feat: initial public release of Oracle SQL Performance Analyzer. + +## Original preparation plan (historical) + +Original heading: Proposed independent public repository — NO PUBLICATION AUTHORIZATION Proposed name: Oracle-Performance-Analyzer. A read-only lookup of Alexisvop/Oracle-Performance-Analyzer returned 404 during local hardening; no name was reserved, and a 404 is not guaranteed availability. PUBLIC_REPOSITORY.json intentionally keeps url null until approved. diff --git a/PUBLIC_RELEASE_AUDIT.md b/PUBLIC_RELEASE_AUDIT.md index 4579bad..bbe8073 100644 --- a/PUBLIC_RELEASE_AUDIT.md +++ b/PUBLIC_RELEASE_AUDIT.md @@ -1,4 +1,6 @@ -# Hardened public-edition release audit +# Historical Hardened public-edition release audit + +**Historical pre-publication snapshot.** The body below records local preparation before the initial public release; its pending-publication and unexecuted-hosted-CI statements apply to that stage. The [public repository](https://github.com/Alexisvop/Oracle-Performance-Analyzer) has since been published at commit fa7237f071fcc0a6996b986835b2681e0ecc0b2e and its [initial hosted CI run](https://github.com/Alexisvop/Oracle-Performance-Analyzer/actions/runs/39892553663) passed. Deployment remains pending and is not authorized. The original observations and decisions below are retained for traceability. This is local agent verification, not independent ChatGPT approval or permission to publish. No Git initialization, commit, remote repository creation, push, visibility change, deployment, Oracle connection/mutation or container operation was performed. diff --git a/PUBLIC_RELEASE_CHECKLIST.md b/PUBLIC_RELEASE_CHECKLIST.md index 5bbff52..b3af0d6 100644 --- a/PUBLIC_RELEASE_CHECKLIST.md +++ b/PUBLIC_RELEASE_CHECKLIST.md @@ -1,4 +1,6 @@ -# Hardened public-edition checklist +# Historical Hardened public-edition checklist + +**Historical pre-publication snapshot.** The body below records local preparation before the initial public release; its pending-publication and unexecuted-hosted-CI statements apply to that stage. The [public repository](https://github.com/Alexisvop/Oracle-Performance-Analyzer) has since been published at commit fa7237f071fcc0a6996b986835b2681e0ecc0b2e and its [initial hosted CI run](https://github.com/Alexisvop/Oracle-Performance-Analyzer/actions/runs/39892553663) passed. Deployment remains pending and is not authorized. The original observations and decisions below are retained for traceability. GO for local completion and independent private review. NO-GO for repository creation, publication or deployment until independent review and separate owner authorization. A verdict is not permission. diff --git a/PUBLIC_REPOSITORY.json b/PUBLIC_REPOSITORY.json index 61b2a95..69130c0 100644 --- a/PUBLIC_REPOSITORY.json +++ b/PUBLIC_REPOSITORY.json @@ -1,8 +1,10 @@ { - "url": null, + "url": "https://github.com/Alexisvop/Oracle-Performance-Analyzer", "proposed_name": "Oracle-Performance-Analyzer", - "status": "Proposed owner name; URL and publication remain gated by independent review and separate authorization", - "publication_authorized": false, + "status": "Public repository published; initial publication authorization consumed; website deployment pending", + "publication_authorized": true, "portfolio_source_mode": "reviewed same-origin static assets", - "name_check": "Read-only GitHub repository lookup returned 404; this is not a reservation or guarantee of availability" + "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 } diff --git a/README.md b/README.md index 03fab10..4dccbdc 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ A reproducible database performance engineering laboratory with a bilingual React portfolio. -**Local release candidate. No repository or website has been published.** This edition contains reviewed code, public technical documentation and a minimal evidence subset exported from a privately developed project. Private development history, personal context, credentials and host diagnostics are excluded. 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. **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). > 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 future public repository URL is intentionally pending. [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; Cloudflare Pages and GitHub Pages have not been deployed. [Frontend guide](portfolio/README.md). ## Results and interpretation @@ -78,7 +78,7 @@ Percentages are computed from unrounded medians. Favorable and unfavorable obser ## Tests, security and licensing -Historical Phase 5 evidence records 180 offline unit tests and 55 subtests; four live integration tests belong to an earlier, separately authorized lab audit. Those are historical counts, not proof of a fresh live execution. Current candidate outcomes are recorded in the release checklist. CI executes offline only; it downloads no Oracle database and holds no database credential. +Historical Phase 5 evidence records 180 offline unit tests and 55 subtests; four live integration tests belong to an earlier, separately authorized lab audit. Those are historical counts, not proof of a fresh live execution. The [initial public GitHub Actions run](https://github.com/Alexisvop/Oracle-Performance-Analyzer/actions/runs/39892553663) passed. Pre-publication outcomes remain in the historical release checklist; immutable export manifests and validation records are explained in [provenance](docs/provenance.md#initial-export-snapshot-and-later-maintenance). CI executes offline only; it downloads no Oracle database and holds no database credential. Keep real credentials local in an owner-owned regular .env file with mode 0600, or supply environment variables. Only .env.example is public. Never run provisioning, reset, DDL, DML, index or DBMS_STATS operations without new, narrowly scoped authorization. Historical receipts cannot authorize repetition. Oracle integration tests are separately marked/gated. diff --git a/docs/provenance.md b/docs/provenance.md index 5650895..96beb4b 100644 --- a/docs/provenance.md +++ b/docs/provenance.md @@ -9,3 +9,7 @@ The [public provenance map](evidence/PROVENANCE.json) records original and publi Third-party dependencies, Oracle software/output labels and trademarks are not automatically relicensed by the owner's MIT grant. [Notices](../THIRD_PARTY_NOTICES.md), [license](../LICENSE), [security](security.md). The E04 comparison authorization field is a digest binding the complete compared artifacts, not a permission to gather statistics. Redacting Git metadata changes those bytes, so the public derivative explicitly rebinds only that offline field. Every other comparison value is retained exactly and the source/derivative hashes are recorded. + +## Initial export snapshot and later maintenance + +EXPORT_MANIFEST.json, its detached checksum, and VALIDATION_RESULTS.json are immutable records of the approved initial export and its pre-publication checks. Their hashes and pending-publication fields describe that snapshot, not the current working tree or current publication status. Verify that export against the [initial public commit](https://github.com/Alexisvop/Oracle-Performance-Analyzer/tree/fa7237f071fcc0a6996b986835b2681e0ecc0b2e). Later documentation changes are tracked by Git and do not regenerate historical checksums or experimental evidence. PUBLIC_REPOSITORY.json contains the current source-publication and deployment metadata. diff --git a/docs/security.md b/docs/security.md index 1521040..3a4d13c 100644 --- a/docs/security.md +++ b/docs/security.md @@ -6,6 +6,6 @@ Offline report/site/test flows need no Oracle credential or connection. Historic Any new provisioning, load/reset, DDL, DML, DBMS_STATS, privilege or container mutation requires separate narrowly scoped owner approval. Oracle DDL may commit implicitly; stop on uncertain outcomes and do not retry/clean up automatically. -Only EXPORT_MANIFEST.json allowlisted files are public candidates. _private_audit, local environments, caches, node_modules, results, release archives and browser logs/screenshots are excluded from distribution. No original .git directory is copied or new Git repository initialized. A future public repository URL remains unconfigured; local evidence navigation works without it. +EXPORT_MANIFEST.json records the initial approved export; subsequent changes require ordinary Git review without rewriting that historical snapshot. _private_audit, local environments, caches, node_modules, results, release archives and browser logs/screenshots remain excluded from distribution. The [public repository](https://github.com/Alexisvop/Oracle-Performance-Analyzer) was initialized with independent history; no original .git directory or private history was copied. Local evidence navigation remains available. Source publication is complete; website deployment is separately gated. [Contributor rules](../AGENTS.md), [development](development.md), [provenance](provenance.md). diff --git a/portfolio/README.md b/portfolio/README.md index 9fd7276..9b2cbe8 100644 --- a/portfolio/README.md +++ b/portfolio/README.md @@ -15,8 +15,8 @@ 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 actual future public repository URL remains pending. 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 portfolio currently runs locally; Cloudflare Pages has not been deployed; deployment still requires separate owner authorization. No automatic deployment workflow exists. -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 are labeled historical; current candidate outcomes are separate. +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). diff --git a/portfolio/scripts/public-assets.ts b/portfolio/scripts/public-assets.ts index 73fddf0..23ac8a1 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 local public edition. The future repository URL is pending.

Documentación, código y evidencia sintética de esta edición pública local. La URL del futuro repositorio está pendiente.

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

OSPA · 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.

')); return assets; } diff --git a/portfolio/src/data/navigation.test.ts b/portfolio/src/data/navigation.test.ts index 711ea2b..3dfac61 100644 --- a/portfolio/src/data/navigation.test.ts +++ b/portfolio/src/data/navigation.test.ts @@ -5,7 +5,7 @@ import { publicAssets, sourceAssetPath, escapeHtml } from '../../scripts/public- import { describe, it, expect } from 'vitest'; import { sourceUrl, repository } from './metrics'; describe('Public reference boundary', () => { - it('uses local reviewed references while the public repository URL is pending', () => { + it('keeps reviewed local references available alongside the published repository', () => { expect(repository).toBe('/source/index.html'); expect(sourceUrl('docs/demo.md#flow-a')).toBe('/source/docs/demo.md.html#flow-a'); expect(sourceUrl('docs/evidence/example.json')).toBe('/source/docs/evidence/example.json'); diff --git a/portfolio/src/i18n.ts b/portfolio/src/i18n.ts index 880e4dc..3534499 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. The future public repository URL is pending.', + 'Reviewed documentation, source files and benchmark evidence are available locally and in the public GitHub repository. The portfolio runs locally; web deployment is pending.', 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. La URL del futuro repositorio público está pendiente.', + '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.', offline: '01 / Demostración sin Oracle', offlineText: 'Ejecuta pruebas unitarias y regenera reportes históricos desde el repositorio. Sin Oracle, contenedores ni credenciales.',