akm-cli 0.10.261130-beta.2 → 0.10.261130-beta.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -24,6 +24,9 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
24
24
  - `akm-cli/workspace`: `assets.bundleFiles` `newFile` names an environment file or a secret (`through: "protected-editor"`) in the top-level `env/` and `secrets/`; `documents.check` names a file by its bundle path, not its scratch folder; `documents.frontmatter` returns `markdown` and `bodyStart` (in a bundle of any adapter) and `applyFrontmatter` the new `bodyStart`; `sensitive.describe` returns `actions: {edit, delete}` with akm's sentence in place of `writable`; `documents.createFile` takes a `type` in place of a folder; `assets.copyEntry` copies a file or folder to a chosen folder; `bundles.list`'s `git.dirtyPaths` is removed (`uncommitted` is the count).
25
25
  - AKM Desktop shows a file's frontmatter as Properties under the title for every kind and edits it as fields (akm applies each change; unknown keys and the body stay as written, with a Text switch for the whole file). A script reads as code, a task as YAML, Source is the whole file. Save checks the text with akm first: findings are listed beside the editor with their lines, a text akm could not read as the asset stops the save with Save anyway, and the file is then shown as not indexed with akm's reason.
26
26
  - `akm-cli/workspace`: `activity.taskHistory` runs carry `targetKind`, `targetRef` and `engine`, and `activity.taskRunLog` returns a task run's recorded output from `logs.db` (read-only; `available: false` when there is none). `setup.detect`'s harnesses carry `modelWorkReadOnly`, whether akm's model calls on that program can be limited to reading and searching. AKM Desktop's task run view shows what the run executed and a Log output section; Setup's "Choose it only if you accept that" follows `modelWorkReadOnly`, not the wording of the note.
27
+ - AKM Desktop's 3D library map is easier to choose from: a point is chosen from anywhere over its drawn disc, whatever the zoom (before, only within a fixed 14 pixels of its middle, which missed a point drawn larger than that), the point under the pointer is ringed, the chosen one is haloed and named by a label that stays over every other mark, and the left and right arrow keys step to the previous or next asset of its group and announce it.
28
+ - AKM Desktop's 3D library map draws three levels of joins from a chosen asset: its joins, theirs and theirs again, each level thinner and more muted than the last (the third dashed) with its assets ringed to match, and a key naming each level with the assets at it. A join is drawn once, at its nearest level; a level shows its 300 most joined assets and the key says how many it left out or could not place on the map. They are the links and near-duplicates `assets.graph` reports; nothing is inferred.
29
+ - AKM Desktop's Activity replay has a 2D / 3D switch (2D by default, the choice kept until the app closes). 3D plays the same events, with the same controls and figures, on the 3D map the Library uses: an asset used so far is in its type's colour, the rest are faint, and the asset an event reads, a search returns or feedback touches is ringed in a colour per kind as it plays. Events on assets with no place on the 3D map, or that the index no longer lists, are counted and said.
27
30
 
28
31
  ### Changed
29
32
 
@@ -49,6 +52,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
49
52
 
50
53
  ### Fixed
51
54
 
55
+ - `akm upgrade --channel <channel>` no longer exits 1 when every installed plugin already follows that channel and one update is `deferred` (OpenCode is running) or `skipped`: the entry reports it, as in an upgrade with no `--channel`. It exited 1 on every such run, so AKM Desktop's Update, which always names the channel, failed whenever OpenCode was open. A plugin left on the other channel still makes the switch exit 1. When akm exits 1 without a failed step, AKM Desktop now shows what akm reported as not done (akm's message and each deferred or skipped plugin with its reason) instead of "AKM's upgrade exited with an error."
52
56
  - AKM Desktop's asset page says why its usage and proposal read failed instead of only that it is unavailable. The Software page's hold on Update no longer guesses from the shape of a version whether Desktop's channel will offer that release.
53
57
  - AKM Desktop's Activity views show what akm reports and say when akm reported nothing. `assets.searchMisses` and `activity.retrievalTrend` return `available: false` with the reason when `state.db` is absent or needs a migration, and the Runs, Usage and search-gap views and the Library map's searches that found nothing say so instead of "No runs recorded" or "No searches"; `activity.overview` names it in `errors.state`. `activity.pulse`, `assets.improvement` and `activity.improveImpact` report an unresolvable bundle directory instead of reading it as no proposals. Needs attention counts every failed task run from akm's full count, not the pulse's three-row preview; the Usage summary calls the proposals counted in its window "updated in this window" instead of "pending"; Repeated search gaps lists the queries akm marks `repeated`.
54
58
  - `activity.improveImpact` returns `usageSince`, `usageComplete` and, per changed asset, `beforeComplete`, so a change whose 28 days before are older than the usage akm keeps shows "Not recorded", not 0. `activity.retrievalTrend` marks `partial` weeks and returns `enoughHistory`: no centre or usual range is drawn from fewer than four whole weeks. `activity.events` rows carry `byPerson`; Replay plays the person's events by default so its figures match the Usage tab, offers everyone's, and shows curates apart from searches. The workflow trace header sums tokens from the attempts akm reported and says "tokens not reported" when none did, and units that name no step get no invented status.
@@ -891,12 +891,11 @@ export async function runUpgrade(args, currentVersion, deps) {
891
891
  // blocked or could not run is not done, and neither is one whose plugin
892
892
  // step failed.
893
893
  const migrationFailed = upgraded.migration?.status === "blocked" || upgraded.migration?.status === "failed";
894
+ // A plugin left on the other channel is a switch that did not happen. A "current" entry there is one the switch
895
+ // left alone on purpose, and a deferred or skipped plugin already follows the channel asked for: its update waits
896
+ // for the harness to exit, as in an upgrade with no --channel, and is reported in its entry.
894
897
  const switchIncomplete = switchChannel !== undefined &&
895
- plugins.some((p) => p.channel !== undefined &&
896
- // A "current" entry still on the other channel is one the switch left alone on purpose.
897
- ((p.channel !== switchChannel && p.outcome !== "current") ||
898
- p.outcome === "deferred" ||
899
- p.outcome === "skipped"));
898
+ plugins.some((p) => p.channel !== undefined && p.channel !== switchChannel && p.outcome !== "current");
900
899
  return {
901
900
  mode: "upgrade",
902
901
  result,
@@ -1970,8 +1970,10 @@ writing settings or fetching Git marketplaces. The CLI's `currentChannel` is
1970
1970
  inferred from its version: prerelease means `next`, otherwise `latest`.
1971
1971
  A configured channel is distinct from a successful refresh: native update
1972
1972
  failures retain the configured target and backup paths but report `failed`.
1973
- An installed plugin that cannot switch, including OpenCode awaiting shutdown,
1974
- makes an explicit switch exit `1`; retry after resolving its reported cause.
1973
+ An installed plugin left on the other channel, including OpenCode awaiting
1974
+ shutdown, makes an explicit switch exit `1`; retry after resolving its reported
1975
+ cause. A plugin already on the channel whose update is `deferred` or `skipped`
1976
+ is reported in its entry and does not, as in an upgrade with no `--channel`.
1975
1977
  The switch is coordinated, not a transaction across independent harnesses.
1976
1978
 
1977
1979
  #### Containers
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "akm-cli",
3
- "version": "0.10.261130-beta.2",
3
+ "version": "0.10.261130-beta.3",
4
4
  "type": "module",
5
5
  "description": "akm (Agent Knowledge Manager) — a portable, local-first capability library for AI agents. Discover, load, share, and improve reusable skills, scripts, workflows, and knowledge across any shell-capable coding agent, including Claude Code, OpenCode, and Cursor.",
6
6
  "keywords": [