Repository navigation
v9
Release Notes: apm-v8 -> current (v9)
TL;DR
- Massive CLI expansion in
pm, includingauth,mcp,update,brutetest,space, and richerprofilecontrols. - Vault format/security expanded with recovery metadata, DEK-based recovery flow, and decoy/session hardening fields.
- Cloud sync moved from Google Drive-only to multi-provider support (Google Drive + GitHub + Dropbox).
- New MCP server/token lifecycle for AI-agent integration.
- Major docs expansion to MkDocs-based documentation + generated site artifacts.
- Test surface significantly increased across
src/*andtests/*.
New Features
pm init allbootstraps vault + cloud setup in one flow.- Account recovery flow via
pm authcommands:pm auth email [address]pm auth alertspm auth level [1-3]pm auth recoverpm auth resetpm auth change
- MCP integration:
pm mcp configpm mcp tokenpm mcp listpm mcp revoke [name_or_token]pm mcp serve
- Self-update flow with
pm update. - Brute-force simulation command:
pm brutetest [minutes]. - Cloud providers expanded:
- Google Drive mode support now includes sync mode handling.
- GitHub sync support.
- Dropbox sync support.
- The user can now setup cloud sync on their own cloud account (for Google Drive and Dropbox) using Oauth2.
- New vault content types in core model:
- Audio files
- Video files
- Photo files
- Space-based segmentation (
space) added for logical partitioning. - Security profile system upgraded with richer interactive controls in
pm profile. - Plugin UX expanded with
plugins searchandplugins local [path].
Enhancements
- Vault path resolution now supports
APM_VAULT_PATH. - Recovery metadata now embedded in vault header paths used by decrypt/recover flows.
- Additional security fields in vault model:
SecurityLevelRecovery*fields (email/hash/token/salt/slot)DecoyMode,DecoySessionCount
- Audit subsystem expanded with local audit file logging (
src/audit.go) and retrieval helpers. - Team binary improvements include optional query in
pm-team get [query]and newpm-team health. - CI workflow updated (
.github/workflows/test.yml) for current toolchain and broader test execution. - Release tooling added via
.goreleaser.yaml. - Docs system introduced with MkDocs config and structured doc hierarchy.
Renames / Semantic Renames
- File rename:
LICENSE.md->LICENSE
- GitHub Actions workflow rename:
.github/workflows/apm-test.yml->.github/workflows/test.yml
- Command/meaning rename:
- Old
profile(namespaces) semantics moved tospace. - Old
sec_profileresponsibilities moved into expandedprofilecommand group.
- Old
- Data model semantic rename:
- Widespread
Namespaceusage moved toSpacein vault entities and filtering logic.
- Widespread
Removals
- Removed personal CLI commands:
adupscansec_profilevsettingsdel [name](delete now handled through newer interactive flows)plugins push [name]
- Removed cloud command signatures (superseded by multi-provider signatures):
cloud init [gdrive]cloud sync [gdrive]cloud get [gdrive] [retrieval_key]
- Removed file:
team/cloud_test.go
CLI Surface Delta
Added personal command signatures:
alertsallauthbrutetest [minutes]changeconfigcurrentemail [address]get [gdrive|github] [retrieval_key|repo]init [gdrive|github]level [1-3]local [path]mcprecoverrevoke [name_or_token]searchservespacesync [gdrive|github]tokenupdate
Removed personal command signatures:
adupdel [name]get [gdrive] [retrieval_key]init [gdrive]push [name]scansec_profilesync [gdrive]vsettings
Added team command signatures:
get [query](optional query variant)health
Added Files (non-generated, exhaustive)
.github/workflows/test.yml.goreleaser.yamldocs/concepts/cloud-sync.mddocs/concepts/encryption.mddocs/concepts/index.mddocs/concepts/mcp.mddocs/concepts/plugins.mddocs/concepts/policy-engine.mddocs/concepts/recovery.mddocs/concepts/secret-types.mddocs/concepts/security-profiles.mddocs/concepts/sessions.mddocs/concepts/vault-format.mddocs/getting-started/features.mddocs/getting-started/first-steps.mddocs/getting-started/help.mddocs/getting-started/index.mddocs/getting-started/installation.mddocs/guides/cloud-sync.mddocs/guides/import-export.mddocs/guides/index.mddocs/guides/mcp-integration.mddocs/guides/plugins.mddocs/guides/sessions.mddocs/guides/team-edition.mddocs/guides/totp.mddocs/guides/vault-management.mddocs/index.mddocs/PLUGIN_API.mddocs/reference/cli.mddocs/reference/environment-variables.mddocs/reference/index.mddocs/reference/mcp-tools.mddocs/reference/plugin-api.mddocs/reference/policies.mddocs/reference/storage.mddocs/requirements.txtdocs/team/approvals.mddocs/team/departments.mddocs/team/index.mddocs/team/rbac.mdexamples/plugins/clip_auto_clear/plugin.jsonexamples/plugins/cloud_sync_hook/plugin.jsonexamples/plugins/quick_backup/plugin.jsonexamples/plugins/safe_add/plugin.jsonexamples/plugins/vault_cleaner/plugin.jsonLICENSEmcp.mdmkdocs.ymlscripts/harden_obf.gosrc/audit.gosrc/audit_test.gosrc/brute.gosrc/cloud_test.gosrc/mcp.gosrc/mcp_integration_test.gosrc/mcp_tools_test.gosrc/policy_test.gosrc/security_test.gosrc/session_test.gosrc/system_profile.gosrc/utils_test.gosrc/vault_test.gotests/brute_force_test.go
Added Generated/Binary Artifacts
build/v9.2/canary/*(3 build artifacts)site/**(86 generated documentation files)pm.exeteam/pm-team.exe
Removed Files (exhaustive)
.github/workflows/apm-test.ymlLICENSE.mdteam/cloud_test.go
Modified Files (non-generated, exhaustive)
.gitignoreexamples/plugins/hello_vault/plugin.jsongo.modgo.summain.goREADME.mdsrc/anomaly.gosrc/cloud.gosrc/cloud_plugins.gosrc/health.gosrc/plugins/definitions.gosrc/plugins/engine.gosrc/plugins/manifest.gosrc/policy.gosrc/portability.gosrc/security.gosrc/session.gosrc/utils.gosrc/vault.goteam/crypto.goteam/go.modteam/go.sumteam/main.goteam/session.goteam/team_vault.gotests/e2e_test.go
Compatibility Notes
- Scripts using
sec_profilemust migrate toprofile. - Scripts using namespace semantics in
profilecommands must migrate tospace. - Cloud command automation should migrate to multi-provider signatures (
[gdrive|github|dropbox]). - Integrations expecting
LICENSE.mdshould referenceLICENSE.
Existing generated outputs (build artifacts, binaries (releases)) are included above as generated/binary additions.