Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
10 changes: 10 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion corp/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
11 changes: 11 additions & 0 deletions docs/INSTALL.md
Original file line number Diff line number Diff line change
@@ -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.
2 changes: 1 addition & 1 deletion docs/INSTALLED-APP-VALIDATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
7 changes: 7 additions & 0 deletions docs/RELEASE-NOTES-UNSIGNED.md
Original file line number Diff line number Diff line change
@@ -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).
2 changes: 2 additions & 0 deletions docs/RELEASE-VALIDATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -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).
2 changes: 2 additions & 0 deletions site/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -499,6 +499,8 @@ <h2>Free forever.<br/><em>MIT licensed.</em></h2>
<a class="btn btn--primary" href="https://github.com/criptogus/keepmind/releases/latest">Download</a>
</div>
</div>
<p class="dl-note">Builds are not code-signed yet. On macOS 15 or later, open the app once, then go to System Settings &gt; Privacy &amp; 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.</p>
<p class="dl-note">KeepMind Corp is a separate installer with its own release: <a href="https://github.com/criptogus/keepmind/releases/tag/corp-v0.2.6">KeepMind Corp 0.2.6</a>.</p>
<p class="dl-note">or <code>git clone</code> + <code>npm run dev</code> — see the README</p>
</div>
</section>
Expand Down
3 changes: 3 additions & 0 deletions src/renderer/src/components/Settings.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -687,6 +687,9 @@ function UpdatesCard({ onToast }: { onToast: Props['onToast'] }) {
<p style={{ fontSize: 12.5, marginBottom: state === 'downloading' ? 8 : 12, color: state === 'ready' ? 'var(--lime)' : state === 'error' ? 'var(--red)' : 'var(--text)' }}>
{label[state] ?? label.idle}
</p>
<p className="faint" style={{ fontSize: 12.5, lineHeight: 1.6, marginBottom: 12 }}>
{'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.'}
</p>
{state === 'downloading' && pct != null && (
<div className="progress-bar" style={{ marginBottom: 12 }}>
<div style={{ width: `${pct}%` }} />
Expand Down
32 changes: 32 additions & 0 deletions tests/installer-contract.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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('&gt;', '>').replaceAll('&amp;', '&')
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('&gt;', '>').replaceAll('&amp;', '&')
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')
}
}
})
Loading