From e0a48473489543c3140a932df890b8014b334e67 Mon Sep 17 00:00:00 2001 From: lozenge0 <7510861+lozenge0@users.noreply.github.com> Date: Sun, 13 Sep 2026 01:05:45 +0100 Subject: [PATCH 1/2] Add AI category and reflect reported Community Apps approval --- CHANGELOG.md | 3 +++ README.md | 27 +++++++++++++++------------ ca_profile.xml | 2 +- docs/RELEASE-REVIEW.md | 35 ++++++++++++++++++++++++++--------- templates/audio-cpp.xml | 4 ++-- tests/test_template.py | 11 ++++++++++- 6 files changed, 57 insertions(+), 25 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 4271eca..a52ff87 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,9 @@ ## Unreleased — targeting v0.1.0 +- Added AI alongside Tools categorization for the base app and inherited CUDA + variants. Replaced pre-submission wording after owner-reported CA auto-approval; + beta status, catalog visibility uncertainty and remaining runtime checks retained. - Initial draft: one Community Apps template with CPU, CUDA 12 and CUDA 13 variants. - Direct moving upstream image references; no application builds or runtime wrappers. - Native model storage, network port and NVIDIA selection fields. diff --git a/README.md b/README.md index d341e16..356328f 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ Community-maintained Unraid templates using **unmodified upstream audio.cpp Docker images** and the upstream WebUI. No fork, custom image, startup wrapper, bundled model, voice recording, or generated server configuration. -**Status: GitHub review draft, targeting v0.1.0; full deployment acceptance pending.** +**Status: beta integration, targeting v0.1.0; full deployment acceptance pending.** CPU, CUDA 12 and CUDA 13 have passed isolated Pocket TTS testing on one Unraid host. Native Docker `--user=99:100` resolved the initial model-folder permission failure. The [September 12 CPU retest](docs/CPU-RETEST-20260912.md) passed short-text, @@ -14,10 +14,13 @@ their documented scope. These are not full Community Apps release acceptance. See the [current release review](docs/RELEASE-REVIEW.md) for completed checks, remaining gates and the exact proposed repository contents. The selected repository destination is `lozenge0/audio-cpp-unraid`, with GitHub -Issues as the integration support destination. The owner approved publishing -this draft for review, not a beta release or Community Apps submission. -See the release review for publication and live-link verification status. -Do not submit this draft to Community Apps yet. +Issues as the integration support destination. The owner reports completing the +Community Apps submission and receiving automatic approval. Catalog visibility +and installation through the public listing are not yet verified. Portal approval +does not establish runtime compatibility. See the release review for current status. + +The template requests both **AI** and **Tools** categories. Catalog placement +depends on CA processing the updated template; it has not yet been confirmed live. ## Scope and layout @@ -229,13 +232,12 @@ The [first hosted run](https://github.com/lozenge0/audio-cpp-unraid/actions/runs passed all 25 checks. See [contribution guidance](CONTRIBUTING.md) and [security reporting](SECURITY.md). -First publish a clearly labelled GitHub draft for owner review, after independent -file/artwork review and explicit creation/push approval. Use a clean standalone -Git history and verify public links and hosted CI after publication. Only later, -complete the CA branch-selection/install checks, review tested images, run CA -Validate/Scan and obtain beta/submission approval. Follow the +The public repository and hosted CI are verified, and the owner reports CA +auto-approval. Next verify catalog visibility and the public branch-selection/install +flow, review tested images and complete or explicitly defer outstanding lifecycle +checks. Rerun CA Validate/Scan after meaningful XML changes. Follow the [GitHub publishing checklist](docs/PUBLISHING.md). Never publish the surrounding -audio.cpp checkout. GitHub review availability is not CA release acceptance. +audio.cpp checkout. Portal approval is not full deployment acceptance. ## Primary references @@ -256,4 +258,5 @@ and tests, not upstream software, third-party dependencies or model weights. The icon is separately dedicated under CC0 1.0 Universal, to the extent the owner holds applicable rights; see [artwork provenance and terms](assets/README.md). The owner approved these choices and subsequent GitHub draft publication on -2026-09-12. Beta release and Community Apps submission remain separate approvals. +2026-09-12. The owner subsequently completed the CA submission and reported +auto-approval. No versioned integration release has been created. diff --git a/ca_profile.xml b/ca_profile.xml index fccbaf2..b31082d 100644 --- a/ca_profile.xml +++ b/ca_profile.xml @@ -1,6 +1,6 @@ - audio.cpp for Unraid: community-maintained templates using unmodified upstream Docker images. This project maintains the Unraid integration, not audio.cpp itself, and is not an official upstream endorsement. Installation support belongs in this repository's issues. Draft: not yet submitted to Community Apps. + audio.cpp for Unraid: community-maintained templates using unmodified upstream Docker images. This project maintains the Unraid integration, not audio.cpp itself, and is not an official upstream endorsement. Installation support belongs in this repository's issues. Beta integration: see the README for tested hardware and remaining deployment checks. https://raw.githubusercontent.com/lozenge0/audio-cpp-unraid/main/assets/icon.svg https://github.com/lozenge0/audio-cpp-unraid diff --git a/docs/RELEASE-REVIEW.md b/docs/RELEASE-REVIEW.md index aa65e27..f5dd261 100644 --- a/docs/RELEASE-REVIEW.md +++ b/docs/RELEASE-REVIEW.md @@ -1,9 +1,10 @@ -# Release review — GitHub review draft +# Release review — beta integration Updated 2026-09-13 (Europe/London). Target: **audio.cpp for Unraid v0.1.0**. -The public GitHub review draft is published; no beta release or CA submission is -approved. This is the current tracker; dated test reports preserve what was known -during each experiment. +The public repository is published. The owner reports completing CA submission +and receiving automatic approval; catalog visibility and public installation are +not yet verified. No versioned integration release has been created. This is the +current tracker; dated test reports preserve what was known during each experiment. ## Proposed repository @@ -20,7 +21,7 @@ during each experiment. - Licence: owner approved root MIT for integration files and CC0 1.0 for the icon on 2026-09-12. The artwork dedication applies only to rights the owner holds; see [artwork terms](../assets/README.md). Subsequent GitHub draft publication is - approved; beta release and CA submission are not. + approved. The owner subsequently completed CA submission and reported auto-approval. ## Completed evidence @@ -57,9 +58,10 @@ Before publishing any repository contents: - [x] Verify the initial public push, hosted CI and repository security settings listed in the publication record below. -Before calling v0.1.0 a Community Apps beta ready for submission: +Post-submission verification and remaining deployment gates: -- [ ] Owner reviews files on GitHub and approves final beta contents/test results. +- [x] Owner reviewed the GitHub files, completed submission and reported auto-approval. +- [ ] Independently verify catalog visibility and the accepted template contents. - [ ] Validate documented optional JSON under UID 99:100, stable model IDs across restart and CLI precedence, or clearly defer that recipe. - [ ] Check the full single-container DockerMan update path and variant-switch @@ -69,8 +71,8 @@ Before calling v0.1.0 a Community Apps beta ready for submission: - [x] Verify GitHub Issues and README/template/raw icon links after approved publication. - [ ] Validate public CA branch selection and installation fields using a supported preview/feed workflow; private pre-expanded entries cannot prove this. -- [ ] Run CA Validate/Scan, resolve findings and obtain explicit submission approval. - Acceptance is the CA reviewers' decision. +- [ ] Review portal Validate/Scan results and rerun after meaningful XML changes. + Owner-reported auto-approval does not prove every runtime acceptance check passed. - [ ] Recheck moving tags before release; update the tested-image record or disclose newer untested images. Do not label a moving tag permanently verified. @@ -182,3 +184,18 @@ The owner subsequently approved the separate GitHub publication step above. The first commit and CI timestamps are September 12 in UTC (after midnight September 13 locally). Dated runtime evidence has not been rerun for publication. No Unraid operations were performed. + +## Category and submission status update + +After publication, the owner reported completing CA submission with automatic +approval, but could not yet find the app in the catalog. The template now requests +`AI Tools:`; both category identifiers are present in the public +[CA category list](https://github.com/Squidly271/AppFeed/blob/master/categoryList.json). +The base and both CUDA branches inherit these categories and retain `Beta=true`. +Removed obsolete pre-submission wording without marking public installation, +DockerMan lifecycle tests or other pending runtime checks complete. No container +image, arguments, mounts, ports, user identity or GPU options were changed. + +The original 25 checks remain, with one additional category/beta regression check. +Catalog processing time and the reason for delayed visibility have not been +established. No duplicate submission or Unraid changes were made for this update. diff --git a/templates/audio-cpp.xml b/templates/audio-cpp.xml index 3759f00..ec70a01 100644 --- a/templates/audio-cpp.xml +++ b/templates/audio-cpp.xml @@ -7,14 +7,14 @@ bash false true - Tools: + AI Tools: http://[IP]:[PORT:8080]/ https://raw.githubusercontent.com/lozenge0/audio-cpp-unraid/main/assets/icon.svg https://github.com/0xShug0/audio.cpp https://github.com/lozenge0/audio-cpp-unraid/issues https://raw.githubusercontent.com/lozenge0/audio-cpp-unraid/main/templates/audio-cpp.xml https://raw.githubusercontent.com/lozenge0/audio-cpp-unraid/main/README.md - audio.cpp for Unraid: community-maintained installation templates using unmodified upstream Docker images and the native WebUI/audio API. Choose CPU, NVIDIA CUDA 12, or NVIDIA CUDA 13 when installing. No models or personal configuration are bundled. Images follow upstream rolling Docker builds, not exclusively numbered releases. DRAFT: isolated runtime and private installation tests passed on one host; public branch selection and full release acceptance remain pending. See the README for tested images and limitations. Not ready for public submission. + audio.cpp for Unraid: community-maintained installation templates using unmodified upstream Docker images and the native WebUI/audio API. Choose CPU, NVIDIA CUDA 12, or NVIDIA CUDA 13 when installing. No models or personal configuration are bundled. Images follow upstream rolling Docker builds, not exclusively numbered releases. BETA: isolated runtime and private installation tests passed on one host; public branch selection and full deployment acceptance remain pending. See the README for tested images and limitations. Trusted-network access only: this setup provides no authentication. Runs as UID 99/GID 100 using Docker --user; model storage must be writable by this identity. Model downloads require network access and adequate storage. CPU variant: no GPU runtime required. Review the README before installation. CPU — no GPU required; upstream rolling image --user=99:100 diff --git a/tests/test_template.py b/tests/test_template.py index 08cd759..9d1a9f8 100644 --- a/tests/test_template.py +++ b/tests/test_template.py @@ -137,12 +137,21 @@ def test_only_repository_assets_not_runtime_payload(self): def test_documented_release_gate(self): readme = (ROOT / "README.md").read_text() self.assertIn("lozenge0/audio-cpp-unraid", readme) - self.assertIn("GitHub review draft", readme) + self.assertIn("beta integration", readme) self.assertIn("full deployment acceptance pending", readme) self.assertTrue((ROOT / "docs/PLAN.md").is_file()) self.assertTrue((ROOT / "docs/VALIDATION.md").is_file()) self.assertIn("MIT License", (ROOT / "LICENSE").read_text()) + def test_ai_category_and_honest_beta_status(self): + for tag, resolved in variants(self.root): + with self.subTest(variant=tag): + self.assertEqual(resolved.findtext("Category").split(), ["AI", "Tools:"]) + self.assertEqual(resolved.findtext("Beta"), "true") + self.assertIn("full deployment acceptance remain pending", resolved.findtext("Overview")) + self.assertNotIn("Not ready for public submission", resolved.findtext("Overview")) + self.assertNotIn("not yet submitted", (ROOT / "ca_profile.xml").read_text()) + def test_selected_publication_destinations(self): base = "https://github.com/lozenge0/audio-cpp-unraid" raw = "https://raw.githubusercontent.com/lozenge0/audio-cpp-unraid/main/" From 04d913c211a4a6ac526f81a365881fe7648265d7 Mon Sep 17 00:00:00 2001 From: lozenge0 <7510861+lozenge0@users.noreply.github.com> Date: Sun, 13 Sep 2026 01:12:27 +0100 Subject: [PATCH 2/2] Align supporting documentation with submitted beta status --- SECURITY.md | 2 +- docs/PLAN.md | 30 +++++++++++++++++------------- docs/PUBLISHING.md | 5 +++-- 3 files changed, 21 insertions(+), 16 deletions(-) diff --git a/SECURITY.md b/SECURITY.md index bb8c96e..776c165 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -1,6 +1,6 @@ # Security -This integration is a draft, with no supported public release yet. Once released, +This integration is beta, with no versioned stable release yet. Once released, maintenance will focus on the current integration template; it does not provide security maintenance for upstream images, dependencies, models or Unraid itself. diff --git a/docs/PLAN.md b/docs/PLAN.md index 4081e83..5f6abb5 100644 --- a/docs/PLAN.md +++ b/docs/PLAN.md @@ -16,7 +16,14 @@ download/inference tests; no ownership-changing helper or `PUID`/`PGID` mapping. - Draft first release v0.1.0; stable integration v1.0.0 after validation. -## Current progress — 2026-09-12 +## Current publication status + +The standalone GitHub repository and CI are live. The owner reports CA submission +and auto-approval; catalog visibility and public installation remain unverified. +The beta template requests AI and Tools categories. See RELEASE-REVIEW.md for the +current evidence and remaining checks. No production migration has been performed. + +## Runtime progress recorded on 2026-09-12 The local template now includes the successfully tested Docker user/group setting. Isolated CPU/CUDA 12/CUDA 13 downloads and browser/API inference passed; CPU/CUDA 13 @@ -61,21 +68,18 @@ because the earlier personal CUDA12 service works. ## Stage 3 — publication identity and beta -GitHub owner and support destination are selected and local URLs updated. The -owner approved MIT for integration files and CC0 for the icon. Verify URLs after -the explicitly approved repository publication. The owner will review the draft -on GitHub; follow PUBLISHING.md for clean history, CI and repository settings. -Initial draft publication is not beta approval. Confirm app/container naming and -category in CA's preview. Local SVG checks at 32/48/180 px on light/dark backgrounds -passed; actual CA rendering remains pending. Publish a small beta only after the -owner approves the exact files and test results. +GitHub publication, support URLs, CI and MIT/CC0 terms are recorded. The owner +reviewed the repository and subsequently submitted it to CA. Follow PUBLISHING.md +for the repository setup record. Confirm app/container naming and category in +the public listing. Local SVG checks at 32/48/180 px on light/dark backgrounds +passed; actual CA rendering and full deployment acceptance remain pending. ## Stage 4 — Community Apps submission -Run the portal's Validate and Scan against the public repository, fix findings, -review metadata/branch previews and submit only with explicit approval. Acceptance -is subject to CA review. Publish integration release notes, supported/tested -combinations, maintenance/support boundaries and rollback guidance. +The owner reports automatic approval. Confirm catalog visibility and review +Validate/Scan results; rerun those checks after meaningful XML changes. Do not +create a duplicate submission because the listing is not yet visible. Preserve +tested-combination limits, maintenance/support boundaries and rollback guidance. ## Ongoing maintenance diff --git a/docs/PUBLISHING.md b/docs/PUBLISHING.md index 567077b..0b346f7 100644 --- a/docs/PUBLISHING.md +++ b/docs/PUBLISHING.md @@ -34,8 +34,9 @@ Approved initialization procedure: files. Verify the remote before pushing `main`. Do not force-push. The draft was published on September 13 (Europe/London); publication checks are -recorded in RELEASE-REVIEW.md. Keep the README and template labelled draft during -GitHub review. No integration release tag or CA submission is part of this push. +recorded in RELEASE-REVIEW.md. The owner subsequently reported CA auto-approval. +Keep the beta label and outstanding validation limits visible. No versioned +integration release has been created; catalog visibility still needs confirmation. ## CI and repository settings