From a114a286475bb0f8babaacefe55147c152b2f59e Mon Sep 17 00:00:00 2001 From: Stephen Phillips Date: Tue, 10 Nov 2026 12:33:46 +0000 Subject: [PATCH] docs: PROGRESS and Spine checkpoint for public release - PROGRESS: public since 2026-11-10, archive repo pointer, #1/#2 deliveries, SonarCloud removal, next checks - Spine: session checkpoint, public-identity decision, IPv6 hostname lesson Co-Authored-By: Claude Opus 5.5 --- .../public-repo-personal-identity-only.md | 12 +++++++ ...-zerogfileman-publicly-with-rewritten-h.md | 36 +++++++++++++++++++ .agent/memories/patterns_and_lessons.md | 6 ++++ PROGRESS.md | 9 ++++- 4 files changed, 62 insertions(+), 1 deletion(-) create mode 100644 .agent/memories/architectural_decisions/public-repo-personal-identity-only.md create mode 100644 .agent/memories/history/2026-11-10T1233Z-published-zerogfileman-publicly-with-rewritten-h.md diff --git a/.agent/memories/architectural_decisions/public-repo-personal-identity-only.md b/.agent/memories/architectural_decisions/public-repo-personal-identity-only.md new file mode 100644 index 0000000..457830e --- /dev/null +++ b/.agent/memories/architectural_decisions/public-repo-personal-identity-only.md @@ -0,0 +1,12 @@ +--- +kind: decision +title: Public repo: personal identity only +tags: [public, git] +sha: 66ad011 +agent: claude-code +created: 2026-11-10 +updated: 2026-11-10 +--- +# Public repo: personal identity only + +ZeroGFileMan is public (MIT). Commit only with the maintainer's personal identity: check the repo-local `git config user.email` before committing. Keep LAN IPs, model hashes and absolute home paths out of committed files; use localhost / placeholders. Pre-public history lives in private archived HappyMonkeyAI/ZeroGFileMan-archive. diff --git a/.agent/memories/history/2026-11-10T1233Z-published-zerogfileman-publicly-with-rewritten-h.md b/.agent/memories/history/2026-11-10T1233Z-published-zerogfileman-publicly-with-rewritten-h.md new file mode 100644 index 0000000..3c0c71a --- /dev/null +++ b/.agent/memories/history/2026-11-10T1233Z-published-zerogfileman-publicly-with-rewritten-h.md @@ -0,0 +1,36 @@ +--- +kind: checkpoint +created: 2026-11-10T12:33:18Z +agent: claude-code +sha: 66ad011 +branch: main +paths: [PROGRESS.md, SECURITY.md, src/shared/endpoints.ts, index.html] +verification: {V0: pass, V1: pass, V2: pass, V3: pass} +id: 2026-11-10T1233Z-published-zerogfileman-publicly-with-rewritten-h +--- +# Checkpoint: Published ZeroGFileMan publicly with rewritten history; added public docs, bund… + +## Summary + +Published ZeroGFileMan publicly with rewritten history; added public docs, bundled fonts, endpoint warnings; removed SonarCloud + +## Done + +- History rewritten (personal email only; LAN IP, model hash, home paths scrubbed); old repo renamed/archived as ZeroGFileMan-archive; fresh repo made public +- PR #1 merged: SECURITY.md, CONTRIBUTING.md, README unsigned-build note; private vuln reporting + topics enabled +- PR #2 merged: fonts bundled (@fontsource-variable), CSP font-src 'self', THIRD-PARTY-NOTICES.md; endpointNotices shown in speech settings; [::1] comment after Amazon Q misread +- SonarCloud projects HappyMonkeyAI_ZeroGFileMan2 and HappyMonkeyAI_ZeroGFileMan deleted + +## Next + +- Check the next PR shows no SonarCloud check; if it does, disable auto-import in the SonarCloud org +- Verify builtin Whisper model download under narrowed CSP connect-src (ADR-0005) + +## Blockers + +- (none) + +## Decisions + +- Repo is public under MIT +- Rebase-merge PRs to keep main linear; when stacking, rebase the child onto main before deleting the parent branch (GitHub closes the child otherwise) diff --git a/.agent/memories/patterns_and_lessons.md b/.agent/memories/patterns_and_lessons.md index bbbc7e8..110e955 100644 --- a/.agent/memories/patterns_and_lessons.md +++ b/.agent/memories/patterns_and_lessons.md @@ -3,3 +3,9 @@ - Prefer greenfield FileMan over forking ZeroG Term (PTY/SSH/MCP weight). - Dual voice jewels (Navigate / Action) beat single-mic intent classification for v1. - Demo speech engine lets UI/fuzzy be tested without ASR model download. + +## URL.hostname keeps IPv6 brackets + +new URL('http://[::1]/').hostname is '[::1]' (brackets kept, also for [0:0:0:0:0:0:0:1]). LOOPBACK_HOSTNAMES in src/shared/endpoints.ts must keep '[::1]'; an Amazon Q review wrongly called it dead code. tests/endpoints.test.ts fails if it is removed. + +_claude-code, 2026-11-10, 66ad011; paths: `src/shared/endpoints.ts`_ diff --git a/PROGRESS.md b/PROGRESS.md index c1e6045..ba256f4 100644 --- a/PROGRESS.md +++ b/PROGRESS.md @@ -2,7 +2,9 @@ ## Current -Code-review hardening merged (#1, #2). Open check: builtin Whisper model download under the narrowed CSP `connect-src` (ADR-0005) — if it fails, allow the host named in the console CSP error. +Public on GitHub since 2026-11-10 (HappyMonkeyAI/ZeroGFileMan, MIT). The history was rewritten before publishing: personal email only, no LAN IPs or home paths. The pre-public history and code-review PRs #1–#3 are in the archived private repo `HappyMonkeyAI/ZeroGFileMan-archive`. PR numbers in this repo restart at #1. + +Open check: builtin Whisper model download under the narrowed CSP `connect-src` (ADR-0005). If it fails, allow the host named in the console CSP error. ## Delivered @@ -14,9 +16,14 @@ Code-review hardening merged (#1, #2). Open check: builtin Whisper model downloa - Server speech requests made by main; key never reaches the renderer; CSP `connect-src` narrowed (ADR-0005) - Right-click context menu on entries and empty listing space (native menu; `src/shared/context-menu.ts`) - Security: filenames can no longer inject cmd.exe syntax via Open with / terminal launchers; dropped files and foreign pages cannot reach `window.fileman` +- Public release prep (#1): SECURITY.md (private vulnerability reporting enabled), CONTRIBUTING.md, README unsigned-build/SmartScreen note, repo topics +- Fonts bundled via `@fontsource-variable/*`, no Google Fonts; CSP `font-src 'self'`; OFL text in THIRD-PARTY-NOTICES.md, shipped in the package (#2) +- Speech settings show endpoint warnings under Server URL: invalid URL, key over plain http off-machine, speech leaving the machine (`endpointNotices`, #2) +- SonarCloud removed for this repo: both FileMan projects deleted in the happymonkeyai SonarCloud org; the org-wide GitHub app is unchanged ## Next +- Confirm the next PR shows no SonarCloud check. If one appears, SonarCloud is auto-importing new repos; turn that off in the SonarCloud org settings. - Later: D5 Pro Commander deck / themes - Optional: SFTP pane