From 7f78b01fdfeab883c35b0b35f383b464d1b100fb Mon Sep 17 00:00:00 2001 From: criptogus <128640021+criptogus@users.noreply.github.com> Date: Sat, 14 Nov 2026 15:06:49 -0300 Subject: [PATCH] docs: macOS 15+ Open Anyway first-launch flow in app, README and release docs; Corp is a separate installer --- CHANGELOG.md | 1 + README.md | 10 ++++++++ corp/README.md | 2 +- docs/INSTALL.md | 11 ++++++++ docs/INSTALLED-APP-VALIDATION.md | 2 +- docs/RELEASE-NOTES-UNSIGNED.md | 7 ++++++ docs/RELEASE-VALIDATION.md | 2 ++ site/index.html | 2 ++ src/renderer/src/components/Settings.tsx | 3 +++ tests/installer-contract.test.ts | 32 ++++++++++++++++++++++++ 10 files changed, 70 insertions(+), 2 deletions(-) create mode 100644 docs/INSTALL.md create mode 100644 docs/RELEASE-NOTES-UNSIGNED.md diff --git a/CHANGELOG.md b/CHANGELOG.md index 6df5940..6ce59b1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -13,6 +13,7 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). - Shared native/MCP persistence and permission tests, encrypted classification inheritance, context budgets, path-alias regressions and renderer DOM interaction coverage. Installed desktop visual inspection remains outstanding. ### Changed +- Docs: clarify unsigned-app first launch on macOS 15+, macOS 14 and Windows across installation help, the app, landing page and reusable release notes; identify the separate KeepMind Corp installer and release repository. - Chat, lexical retrieval, RAG and standalone MCP share current/history/as-of fact selection. Every retrieved fact fragment retains its status label; corrections refresh the index before the next query. - The MCP bundle now includes `lib/memory-contract.mjs` and `lib/continuity.mjs`; packaging and native materialization include both modules. - Hoje calls the existing word-presence evaluation “Retrieval checks” to distinguish it from model-answer accuracy. diff --git a/README.md b/README.md index f7c97d7..65c450b 100644 --- a/README.md +++ b/README.md @@ -109,6 +109,16 @@ npm run corp:build-brain && npm run corp See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for details. +## Install + +Download the personal app from [KeepMind releases](https://github.com/criptogus/keepmind/releases) and choose the installer for your operating system. + +Builds are not code-signed yet. On macOS 15 or later, open the app once, then go to System Settings > Privacy & Security and choose Open Anyway. On macOS 14 or earlier, you can also right-click the app and choose Open. On Windows, choose More info, then Run anyway. + +KeepMind Corp is a separate installer with its own GitHub release; the personal installer does not install Corp. The current stable Corp release is [`corp-v0.2.6`](https://github.com/criptogus/keepmind/releases/tag/corp-v0.2.6) in this repository. On `main`, `electron-builder.corp.yml` publishes later Corp builds to [criptogus/keepmind-corp](https://github.com/criptogus/keepmind-corp/releases). + +See [installation and first-launch help](docs/INSTALL.md). + ## Quickstart ```bash diff --git a/corp/README.md b/corp/README.md index 2bb63a5..0f63eb6 100644 --- a/corp/README.md +++ b/corp/README.md @@ -109,7 +109,7 @@ Tag no repositório dispara build nos três sistemas: git tag corp-v0.1.0 && git push origin corp-v0.1.0 ``` -Artefatos ficam na **GitHub Release** ligada à tag (workflow `release-corp.yml`). +Artefatos ficam na **GitHub Release** ligada à tag (workflow `release-corp.yml`). O KeepMind Corp tem instalador separado e release própria (por exemplo, `corp-v0.2.6`). Na branch `main`, `electron-builder.corp.yml` configura a publicação em `criptogus/keepmind-corp`. A release estável atual é a [corp-v0.2.6](https://github.com/criptogus/keepmind/releases/tag/corp-v0.2.6), neste repositório; builds posteriores ficam nos [releases do keepmind-corp](https://github.com/criptogus/keepmind-corp/releases). Consulte também e as [instruções de instalação e primeira abertura](../docs/INSTALL.md). ## Armazenamento cifrado do CRM Corp diff --git a/docs/INSTALL.md b/docs/INSTALL.md new file mode 100644 index 0000000..8b73e26 --- /dev/null +++ b/docs/INSTALL.md @@ -0,0 +1,11 @@ +# Install and first launch + +Download the personal app from [KeepMind releases](https://github.com/criptogus/keepmind/releases). Choose the macOS `.dmg` (open it and drag KeepMind to Applications), Windows `.exe` (run the installer), or Linux `.AppImage` (make it executable and run it). + +Builds are not code-signed yet. On macOS 15 or later, open the app once, then go to System Settings > Privacy & Security and choose Open Anyway. On macOS 14 or earlier, you can also right-click the app and choose Open. On Windows, choose More info, then Run anyway. + +## KeepMind Corp + +KeepMind Corp is a separate installer with its own GitHub release; the personal installer does not install Corp. The current stable Corp release is [`corp-v0.2.6`](https://github.com/criptogus/keepmind/releases/tag/corp-v0.2.6) in this repository. On `main`, `electron-builder.corp.yml` publishes later Corp builds to [criptogus/keepmind-corp](https://github.com/criptogus/keepmind-corp/releases). + +Corp uses Windows `.exe`, macOS `.dmg` and Linux `.AppImage` installers. The same first-launch instructions above apply. See [Corp setup](../corp/README.md) for organization configuration. diff --git a/docs/INSTALLED-APP-VALIDATION.md b/docs/INSTALLED-APP-VALIDATION.md index e620e3c..e4bfab9 100644 --- a/docs/INSTALLED-APP-VALIDATION.md +++ b/docs/INSTALLED-APP-VALIDATION.md @@ -16,7 +16,7 @@ The old `continuous.yml` used the personal packaging configuration even inside ` Downloads require the expected repository, edition-specific filename, positive size and SHA-256 digest. Partial or corrupted downloads are not installable. Pending metadata persists across restart. The macOS helper stages the replacement on the installation volume, keeps the old bundle for recovery, and preserves the profile when launching directly. It does not use LaunchServices to choose another app. Linux requires a real AppImage path and stages a replacement. Windows waits for the old process, installs to its existing directory, checks the installer exit status, then relaunches with the same profile. A receipt is written after replacement, not after download. -These changes do not add signing/notarization or remote account recovery. Existing unsigned application restrictions still apply. A local source-package smoke is not evidence that a published release contains the fix. +These changes do not add signing/notarization or remote account recovery. Builds are not code-signed yet. On macOS 15 or later, open the app once, then go to System Settings > Privacy & Security and choose Open Anyway. On macOS 14 or earlier, you can also right-click the app and choose Open. On Windows, choose More info, then Run anyway. A local source-package smoke is not evidence that a published release contains the fix. ## Reusable tests diff --git a/docs/RELEASE-NOTES-UNSIGNED.md b/docs/RELEASE-NOTES-UNSIGNED.md new file mode 100644 index 0000000..c03536a --- /dev/null +++ b/docs/RELEASE-NOTES-UNSIGNED.md @@ -0,0 +1,7 @@ +# First-launch snippet for GitHub release notes + +Copy the following into release notes for either desktop edition: + +Builds are not code-signed yet. On macOS 15 or later, open the app once, then go to System Settings > Privacy & Security and choose Open Anyway. On macOS 14 or earlier, you can also right-click the app and choose Open. On Windows, choose More info, then Run anyway. + +KeepMind Corp is a separate installer with its own GitHub release; the personal installer does not install Corp. The current stable Corp release is [`corp-v0.2.6`](https://github.com/criptogus/keepmind/releases/tag/corp-v0.2.6) in this repository. On `main`, `electron-builder.corp.yml` publishes later Corp builds to [criptogus/keepmind-corp](https://github.com/criptogus/keepmind-corp/releases). diff --git a/docs/RELEASE-VALIDATION.md b/docs/RELEASE-VALIDATION.md index e77110f..64d599a 100644 --- a/docs/RELEASE-VALIDATION.md +++ b/docs/RELEASE-VALIDATION.md @@ -16,4 +16,6 @@ CI retains smoke reports and screenshots for 14 days, including failed runs when Run `npm run check:release-gates` for the aggregate structural check (nonzero on failure). Run the CI commands for execution evidence, then `node scripts/check-release-gates.mjs --reports`. See `.agents/skills/release-validation/SKILL.md` for the reusable validation procedure. Neither command publishes anything. Static mutation tests validate the checker, not GitHub's scheduler. A real tagged release is deliberately not part of PR validation. +For release notes, paste the [unsigned-app first-launch snippet](RELEASE-NOTES-UNSIGNED.md). See [installation help](INSTALL.md) for the separate personal and Corp downloads. + References: [reusable workflows](https://docs.github.com/en/actions/how-tos/reuse-automations/reuse-workflows), [workflow syntax and job dependencies](https://docs.github.com/en/actions/reference/workflows-and-actions/workflow-syntax). diff --git a/site/index.html b/site/index.html index 99b7fac..98674bd 100644 --- a/site/index.html +++ b/site/index.html @@ -499,6 +499,8 @@

Free forever.
MIT licensed.

Download +

Builds are not code-signed yet. On macOS 15 or later, open the app once, then go to System Settings > Privacy & Security and choose Open Anyway. On macOS 14 or earlier, you can also right-click the app and choose Open. On Windows, choose More info, then Run anyway.

+

KeepMind Corp is a separate installer with its own release: KeepMind Corp 0.2.6.

or git clone + npm run dev — see the README

diff --git a/src/renderer/src/components/Settings.tsx b/src/renderer/src/components/Settings.tsx index 20f2499..e4e4069 100644 --- a/src/renderer/src/components/Settings.tsx +++ b/src/renderer/src/components/Settings.tsx @@ -687,6 +687,9 @@ function UpdatesCard({ onToast }: { onToast: Props['onToast'] }) {

{label[state] ?? label.idle}

+

+ {'Builds are not code-signed yet. On macOS 15 or later, open the app once, then go to System Settings > Privacy & Security and choose Open Anyway. On macOS 14 or earlier, you can also right-click the app and choose Open. On Windows, choose More info, then Run anyway.'} +

{state === 'downloading' && pct != null && (
diff --git a/tests/installer-contract.test.ts b/tests/installer-contract.test.ts index 24f65e4..8c8fe7b 100644 --- a/tests/installer-contract.test.ts +++ b/tests/installer-contract.test.ts @@ -16,3 +16,35 @@ it('publishes the Corp desktop entrypoint/resources instead of the personal appl expect(steps.some((s:any)=>s.run==='npm run corp:build-brain' && s.if.includes('keepmind-corp'))).toBe(true) expect(steps.find((s:any)=>s.uses?.startsWith('actions/upload-artifact')).with.path).toContain("'dist-corp' || 'dist'") }) + +const unsignedLaunchHelp = 'Builds are not code-signed yet. On macOS 15 or later, open the app once, then go to System Settings > Privacy & Security and choose Open Anyway. On macOS 14 or earlier, you can also right-click the app and choose Open. On Windows, choose More info, then Run anyway.' + +it('keeps canonical first-launch help in docs, the app and the deployed landing page', () => { + for (const file of [ + 'README.md', 'docs/INSTALL.md', 'docs/RELEASE-NOTES-UNSIGNED.md', + 'src/renderer/src/components/Settings.tsx', 'site/index.html' + ]) { + const source = readFileSync(file, 'utf8').replaceAll('>', '>').replaceAll('&', '&') + expect(source, file).toContain(unsignedLaunchHelp) + } +}) + +it('never offers right-click Open without the macOS 15 first-launch flow', async () => { + const { readdirSync } = await import('node:fs') + const { join } = await import('node:path') + const filesUnder = (path: string): string[] => readdirSync(path, { withFileTypes: true }).flatMap(entry => { + const file = join(path, entry.name) + return entry.isDirectory() ? filesUnder(file) : /\.(md|html|tsx?|jsx?)$/.test(file) ? [file] : [] + }) + const files = ['README.md', 'CHANGELOG.md', 'tools/README.md', 'corp/README.md', + ...['docs', 'src/renderer', 'corp/public', 'site'].flatMap(filesUnder)] + for (const file of files) { + const source = readFileSync(file, 'utf8').replaceAll('>', '>').replaceAll('&', '&') + for (const match of source.matchAll(/right[ -]click[^.\n]{0,160}\bOpen\b/gi)) { + // Require the modern flow in the same paragraph/instruction, not elsewhere in the file. + const preceding = source.slice(Math.max(0, match.index! - 400), match.index) + expect(preceding, file).toContain('On macOS 15 or later, open the app once, then go to System Settings > Privacy & Security and choose Open Anyway.') + expect(preceding, file).toContain('On macOS 14 or earlier') + } + } +})