akm-cli 0.9.0-beta.48 → 0.9.0-beta.49

package/dist/commands/agent/agent-dispatch.js

@@ -18,7 +18,7 @@ import { parseAssetRef } from "../../core/asset/asset-ref.js";
 import { NotFoundError, UsageError } from "../../core/errors.js";
 import { requireAgentProfile } from "../../integrations/agent/config.js";
 import { runAgent } from "../../integrations/agent/spawn.js";
-import { runAgentSdk } from "../../integrations/harnesses/opencode-sdk/index.js";
+import { runOpencodeSdk } from "../../integrations/harnesses/opencode-sdk/index.js";
 /**
  * Fill `{{0}}`, `{{1}}`, ... placeholders in `template` with the
  * corresponding entries in `args`. Any placeholder index that exceeds the
@@ -93,7 +93,7 @@ export async function akmAgentDispatch(options) {
         ...(dispatchRequest !== undefined ? { dispatch: dispatchRequest } : {}),
     };
     const result = profile.sdkMode
-        ? await runAgentSdk(profile, prompt ?? "", runOptions, options.llmConfig)
+        ? await runOpencodeSdk(profile, prompt ?? "", runOptions, options.llmConfig)
         : await runAgent(profile, prompt, runOptions);
     return {
         schemaVersion: 1,

package/dist/commands/agent/agent-support.js

@@ -1,13 +1,6 @@
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this
 // file, You can obtain one at https://mozilla.org/MPL/2.0/.
-/**
- * Shared helpers for agent-based commands (reflect, propose, etc.).
- *
- * Consolidates utility functions that were duplicated byte-for-byte across
- * `reflect.ts` and `propose.ts`. Any command that shells out to an agent
- * profile can import from here rather than copy-pasting.
- */
 import { loadConfig } from "../../core/config/config.js";
 import { requireAgentProfile, } from "../../integrations/agent/index.js";
 // ── Config helpers ───────────────────────────────────────────────────────────

package/dist/commands/agent/contribute-cli.js

@@ -29,7 +29,7 @@ import { assertFlatAssetName, combineCreatePath, normalizeCreateSubPath } from "
 import { loadConfig } from "../../core/config/config.js";
 import { UsageError } from "../../core/errors.js";
 import { getHyphenatedArg } from "../../output/context.js";
-import { akmLint } from "../lint.js";
+import { akmLint } from "../lint/index.js";
 import { akmPropose } from "../proposal/propose.js";
 import { akmAgentDispatch } from "./agent-dispatch.js";
 const EXIT_GENERAL = EXIT_CODES.GENERAL;

package/dist/commands/proposal/propose.js

@@ -22,7 +22,7 @@ import { resolveStandardsContext } from "../../core/standards/resolve-standards-
 import { runAgent, } from "../../integrations/agent/index.js";
 import { resolveProcessAgentProfile } from "../../integrations/agent/config.js";
 import { buildProposePrompt, parseAgentProposalPayload } from "../../integrations/agent/prompts.js";
-import { runAgentSdk } from "../../integrations/harnesses/opencode-sdk/index.js";
+import { runOpencodeSdk } from "../../integrations/harnesses/opencode-sdk/index.js";
 import { baseFailureFields, enoentHintMessage, isEnoentFailure, loadAgentConfigFromDisk, resolveAgentProfile, } from "../agent/agent-support.js";
 import { createProposal, isProposalSkipped, } from "./validators/proposals.js";
 function failureEnvelope(result, type, name, fallbackReason = "non_zero_exit") {
@@ -128,7 +128,7 @@ export async function akmPropose(options) {
             ...(resolvedTimeoutMs !== undefined ? { timeoutMs: resolvedTimeoutMs } : {}),
         };
         result = profile.sdkMode
-            ? await runAgentSdk(profile, prompt ?? "", runOptions)
+            ? await runOpencodeSdk(profile, prompt ?? "", runOptions)
             : await runAgent(profile, prompt, runOptions);
     }
     if (!result.ok) {

package/dist/commands/tasks/tasks.js

@@ -20,7 +20,7 @@ import { listAgentProfileNames } from "../../integrations/agent/index.js";
 import { resolveAssetPath } from "../../sources/resolve.js";
 import { backendNameForPlatform, selectBackend } from "../../tasks/backends/index.js";
 import { parseTaskDocument } from "../../tasks/parser.js";
-import { resolveAkmInvocation } from "../../tasks/resolveAkmBin.js";
+import { resolveAkmInvocation } from "../../tasks/resolve-akm-bin.js";
 import { exitCodeForStatus, readTaskHistory, runTask } from "../../tasks/runner.js";
 import { parseSchedule, SCHEDULE_SUPPORTED_SUBSET_HINT, translateToCron } from "../../tasks/schedule.js";
 import { validateTaskDocument } from "../../tasks/validator.js";

package/dist/core/common.js

@@ -44,11 +44,6 @@ export function isRemoteUrl(value) {
         value.startsWith("ssh://") ||
         value.startsWith("git://"));
 }
-export function filterNonEmptyStrings(value) {
-    if (!Array.isArray(value))
-        return undefined;
-    return value.filter((entry) => typeof entry === "string" && entry.trim().length > 0);
-}
 // ── Validators ──────────────────────────────────────────────────────────────
 /**
  * Returns true if `type` is a known asset type — either a built-in from

package/dist/core/config/config-types.js

@@ -9,8 +9,8 @@ import { VALID_HARNESS_IDS } from "../../integrations/harnesses/index.js";
 /**
  * Canonical list of valid agent harness / platform ids. Re-exported from the
  * unified harness registry (#562) so the Zod `AgentPlatformSchema` enum, the
- * `AgentProfileConfigV2` platform union, `parseAgentProfilesMapV2`'s membership
- * check, and setup's `DetectedHarness` union all derive from one place and
- * cannot drift. Add a harness in `src/integrations/harnesses/index.ts`.
+ * `AgentProfileConfig` platform union, and setup's `DetectedHarness` union all
+ * derive from one place and cannot drift. Add a harness in
+ * `src/integrations/harnesses/index.ts`.
  */
 export { VALID_HARNESS_IDS };

package/dist/core/state-db.js

@@ -469,22 +469,70 @@ export function insertProposalIfAbsent(db, proposal, stashDir) {
  * need the write lock BEFORE those reads so concurrent processes serialize on
  * the live queue state rather than clobbering each other.
  */
+/**
+ * Errors `BEGIN IMMEDIATE` can throw under concurrent-writer contention that are
+ * transient (the statement did NOT start a usable transaction) and safe to
+ * retry after clearing any phantom transaction state:
+ *   - "database is locked" / SQLITE_BUSY — another writer holds the lock.
+ *   - "cannot start a transaction within a transaction" — bun:sqlite can leave
+ *     the connection reporting an open transaction after a contended busy-wait
+ *     on BEGIN IMMEDIATE (observed only under heavy parallel load, e.g. the
+ *     proposal-queue worker race). A ROLLBACK clears that phantom state.
+ * These are start-of-transaction failures only; an error thrown by `fn` is a
+ * real failure and is NEVER retried.
+ */
+function isRetryableBeginError(err) {
+    const msg = (err instanceof Error ? err.message : String(err)).toLowerCase();
+    return (msg.includes("within a transaction") ||
+        msg.includes("database is locked") ||
+        msg.includes("database table is locked"));
+}
+const WITH_IMMEDIATE_TX_MAX_ATTEMPTS = 5;
+/** Portable synchronous sleep (works under both Bun and Node). */
+function sleepSyncMs(ms) {
+    if (ms <= 0)
+        return;
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
 export function withImmediateTransaction(db, fn) {
-    db.exec("BEGIN IMMEDIATE");
-    try {
-        const result = fn();
-        db.exec("COMMIT");
-        return result;
-    }
-    catch (err) {
+    let lastBeginErr;
+    for (let attempt = 1; attempt <= WITH_IMMEDIATE_TX_MAX_ATTEMPTS; attempt++) {
         try {
-            db.exec("ROLLBACK");
+            db.exec("BEGIN IMMEDIATE");
         }
-        catch {
-            // Ignore rollback failures so the original error is preserved.
+        catch (err) {
+            lastBeginErr = err;
+            if (isRetryableBeginError(err) && attempt < WITH_IMMEDIATE_TX_MAX_ATTEMPTS) {
+                // Clear any phantom/stale transaction left by the contended BEGIN, then
+                // retry with a small backoff so concurrent writers serialize cleanly.
+                try {
+                    db.exec("ROLLBACK");
+                }
+                catch {
+                    // No active transaction to roll back — fine.
+                }
+                sleepSyncMs(2 ** (attempt - 1));
+                continue;
+            }
+            throw err;
+        }
+        try {
+            const result = fn();
+            db.exec("COMMIT");
+            return result;
+        }
+        catch (err) {
+            try {
+                db.exec("ROLLBACK");
+            }
+            catch {
+                // Ignore rollback failures so the original error is preserved.
+            }
+            throw err; // a real error inside the transaction body — never retried.
         }
-        throw err;
     }
+    // Exhausted retries on transient begin failures.
+    throw lastBeginErr;
 }
 // ── task_history table helpers ───────────────────────────────────────────────
 /**

package/dist/integrations/agent/config.js

@@ -1,9 +1,7 @@
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this
 // file, You can obtain one at https://mozilla.org/MPL/2.0/.
-import { VALID_HARNESS_IDS } from "../../core/config/config.js";
 import { ConfigError } from "../../core/errors.js";
-import { warn } from "../../core/warn.js";
 import { BUILTIN_AGENT_PROFILE_NAMES, getBuiltinAgentProfile, listBuiltinAgentProfiles, } from "./profiles.js";
 /**
  * Default hard timeout for an agent CLI (60s — matches the value used in
@@ -41,7 +39,12 @@ export function resolveAgentProfile(name, overrides) {
         stdio: base.stdio,
         env: base.env,
         envPassthrough: base.envPassthrough,
-        timeoutMs: base.timeoutMs,
+        // Honor a user-configured `profiles.agent.<name>.timeoutMs` override; fall
+        // back to the built-in profile's value. (Previously always used base, so
+        // the documented config override was silently ignored — callers had to pass
+        // a CLI flag like `--timeout-ms`.) runAgent (spawn.ts) reads profile.timeoutMs
+        // when no per-call timeout is supplied, so this makes the config knob work.
+        timeoutMs: overrides.timeoutMs ?? base.timeoutMs,
         parseOutput: base.parseOutput,
         ...(sdkMode ? { sdkMode: true } : {}),
         model: overrides.model ?? base.model,
@@ -134,53 +137,3 @@ export function listResolvedAgentProfiles(config) {
     }
     return resolved;
 }
-/**
- * Parse the v2 `profiles.agent` map (AgentProfileConfigV2 shape with required
- * `platform` field). Returns a map of profile name → AgentProfileConfigV2.
- */
-export function parseAgentProfilesMapV2(value) {
-    if (typeof value !== "object" || value === null || Array.isArray(value))
-        return undefined;
-    const out = {};
-    // Derives from the canonical harness-id source of truth (#565).
-    const VALID_PLATFORMS = VALID_HARNESS_IDS;
-    for (const [name, raw] of Object.entries(value)) {
-        if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
-            warn(`[akm] Ignoring profiles.agent["${name}"]: expected an object.`);
-            continue;
-        }
-        const obj = raw;
-        if (!VALID_PLATFORMS.includes(obj.platform)) {
-            warn(`[akm] Ignoring profiles.agent["${name}"]: missing or invalid "platform" (must be one of: ${VALID_PLATFORMS.join(", ")}).`);
-            continue;
-        }
-        const profile = {
-            platform: obj.platform,
-        };
-        if (typeof obj.bin === "string" && obj.bin.trim())
-            profile.bin = obj.bin.trim();
-        if (Array.isArray(obj.args) && obj.args.every((a) => typeof a === "string")) {
-            profile.args = obj.args;
-        }
-        if (typeof obj.workspace === "string" && obj.workspace.trim())
-            profile.workspace = obj.workspace.trim();
-        if (typeof obj.model === "string" && obj.model.trim())
-            profile.model = obj.model.trim();
-        out[name] = profile;
-    }
-    return Object.keys(out).length > 0 ? out : undefined;
-}
-/**
- * Stub kept for source-compat with callers that previously used the v1 agent
- * config parser. After 0.8.0 there is no separate `agent` block to parse — the
- * loaded `AkmConfig` already carries the agent data on `profiles.agent` and
- * `defaults.agent`. This function is a no-op alias for those callers.
- *
- * @deprecated v0.8.0 — the unified `AkmConfig` IS the agent config. Use the
- * profile/defaults accessors above instead.
- */
-export function parseAgentConfig(_value) {
-    // No-op: there is no separate agent block in 0.8.0. Callers should pass
-    // their loaded `AkmConfig` directly to `requireAgentProfile` etc.
-    return undefined;
-}

package/dist/integrations/agent/index.js

@@ -1,26 +1,10 @@
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this
 // file, You can obtain one at https://mozilla.org/MPL/2.0/.
-/**
- * Internal entry point for the `agent` integration. CLI-only project — no
- * public exports map. Other akm modules import from this barrel for the
- * sake of grouping imports.
- *
- * Surface:
- *   • Types: AgentProfile, AgentConfig, AgentRunResult, AgentFailureReason.
- *   • Profiles: getBuiltinAgentProfile, listBuiltinAgentProfiles, BUILTIN_AGENT_PROFILE_NAMES.
- *   • Config: parseAgentConfig, resolveProfileFromConfig, requireAgentProfile, listResolvedAgentProfiles, listAgentProfileNames.
- *   • Spawn: runAgent. Builders: getCommandBuilder, AgentCommandBuilder, AgentDispatchRequest — platform-specific argv construction.
- *   • Detection: detectAgentCliProfiles, pickDefaultAgentProfile, defaultWhich.
- */
-// The OpenCode SDK runner moved to its harness directory in #564
-// (`harnesses/opencode-sdk/`). Re-exported here so existing `agent/index`
-// import sites keep working.
-export { runAgentSdk } from "../harnesses/opencode-sdk/index.js";
 export { getCommandBuilder } from "./builders.js";
-export { DEFAULT_AGENT_TIMEOUT_MS, listAgentProfileNames, listResolvedAgentProfiles, parseAgentConfig, requireAgentProfile, resolveAgentProfile, resolveDefaultProfileName, resolveProfileFromConfig, } from "./config.js";
+export { DEFAULT_AGENT_TIMEOUT_MS, listAgentProfileNames, listResolvedAgentProfiles, requireAgentProfile, resolveAgentProfile, resolveDefaultProfileName, resolveProfileFromConfig, } from "./config.js";
 export { defaultWhich, detectAgentCliProfiles, pickDefaultAgentProfile } from "./detect.js";
 export { listBuiltinModelAliases, resolveModel } from "./model-aliases.js";
 export { BUILTIN_AGENT_PROFILE_NAMES, getBuiltinAgentProfile, listBuiltinAgentProfiles, } from "./profiles.js";
-export { buildProposePrompt, buildReflectPrompt, buildSchemaRepairPrompt, extractDraftConfidence, parseAgentProposalPayload, stripJsonFences, } from "./prompts.js";
+export { buildProposePrompt, buildReflectPrompt, buildSchemaRepairPrompt, extractDraftConfidence, parseAgentProposalPayload, } from "./prompts.js";
 export { runAgent } from "./spawn.js";

package/dist/integrations/agent/prompts.js

@@ -444,11 +444,3 @@ export function parseAgentProposalPayload(stdout) {
     }
     return out;
 }
-/**
- * Strip `\`\`\`json … \`\`\`` fences and `<think>…</think>` reasoning blocks
- * from agent output. Thin wrapper around `core/parse` helpers, kept exported
- * for backward compatibility (re-exported from `integrations/agent/index.ts`).
- */
-export function stripJsonFences(text) {
-    return stripCodeFences(stripThinkBlocks(text));
-}

package/dist/integrations/harnesses/index.js

@@ -60,9 +60,8 @@ const HARNESS_BY_ANY_ID = (() => {
 })();
 /**
  * Canonical, ordered list of valid harness / platform ids. The Zod
- * `AgentPlatformSchema` enum, the `AgentProfileConfigV2` platform union,
- * `parseAgentProfilesMapV2`'s membership check, and setup's `DetectedHarness`
- * union all derive from this so they cannot drift.
+ * `AgentPlatformSchema` enum, the `AgentProfileConfig` platform union, and
+ * setup's `DetectedHarness` union all derive from this so they cannot drift.
  */
 export const VALID_HARNESS_IDS = Object.freeze(HARNESS_REGISTRY.map((h) => h.id));
 /** Harnesses that expose readable native session logs. */

package/dist/integrations/harnesses/opencode-sdk/index.js

@@ -5,7 +5,7 @@
  * OpenCode SDK harness (#564).
  *
  * Per-harness barrel for the SDK-mode dispatch path:
- *   - agent runner → ./sdk-runner.ts (runOpencodeSdk / runAgentSdk)
+ *   - agent runner → ./sdk-runner.ts (runOpencodeSdk)
  *
  * It also defines {@link OpencodeSdkHarness}, the {@link AkmHarness} descriptor
  * that `HARNESS_REGISTRY` registers.
@@ -17,7 +17,7 @@
  * names. Canonical id is `'opencode-sdk'` with no alias.
  */
 import { BaseHarness } from "../types.js";
-export { closeServer, runAgentSdk, runOpencodeSdk } from "./sdk-runner.js";
+export { closeServer, runOpencodeSdk } from "./sdk-runner.js";
 function caps(c) {
     return {
         sessionLogs: false,

package/dist/integrations/harnesses/opencode-sdk/sdk-runner.js

@@ -230,5 +230,3 @@ export async function runOpencodeSdk(profile, prompt, opts = {}, llmConfig) {
         await client.session.delete({ path: { id: sessionId } }).catch(() => { });
     }
 }
-/** @deprecated Use {@link runOpencodeSdk} instead. */
-export const runAgentSdk = runOpencodeSdk;

package/dist/output/context.js

@@ -12,10 +12,10 @@
  * Initialized from `cli.ts` before `runMain`.
  */
 import { UsageError } from "../core/errors.js";
-export const OUTPUT_FORMATS = ["json", "yaml", "text", "jsonl", "md", "html"];
-export const DETAIL_LEVELS = ["brief", "normal", "full"];
-export const SHAPE_MODES = ["human", "agent", "summary"];
-export function parseOutputFormat(value) {
+const OUTPUT_FORMATS = ["json", "yaml", "text", "jsonl", "md", "html"];
+const DETAIL_LEVELS = ["brief", "normal", "full"];
+const SHAPE_MODES = ["human", "agent", "summary"];
+function parseOutputFormat(value) {
     if (!value)
         return undefined;
     if (OUTPUT_FORMATS.includes(value))
@@ -29,7 +29,7 @@ export function parseDetailLevel(value) {
         return value;
     throw new UsageError(`Invalid value for --detail: ${value}. Expected one of: ${DETAIL_LEVELS.join("|")}`, "INVALID_DETAIL_VALUE");
 }
-export function parseShapeMode(value) {
+function parseShapeMode(value) {
     if (!value)
         return undefined;
     if (SHAPE_MODES.includes(value))

package/dist/scripts/migrate-storage.js

@@ -9699,18 +9699,43 @@ function insertProposalIfAbsent(db, proposal, stashDir) {
   const changes = result.changes ?? 0;
   return Number(changes) > 0;
 }
+function isRetryableBeginError(err) {
+  const msg = (err instanceof Error ? err.message : String(err)).toLowerCase();
+  return msg.includes("within a transaction") || msg.includes("database is locked") || msg.includes("database table is locked");
+}
+function sleepSyncMs(ms) {
+  if (ms <= 0)
+    return;
+  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
 function withImmediateTransaction(db, fn) {
-  db.exec("BEGIN IMMEDIATE");
-  try {
-    const result = fn();
-    db.exec("COMMIT");
-    return result;
-  } catch (err) {
+  let lastBeginErr;
+  for (let attempt = 1;attempt <= WITH_IMMEDIATE_TX_MAX_ATTEMPTS; attempt++) {
     try {
-      db.exec("ROLLBACK");
-    } catch {}
-    throw err;
+      db.exec("BEGIN IMMEDIATE");
+    } catch (err) {
+      lastBeginErr = err;
+      if (isRetryableBeginError(err) && attempt < WITH_IMMEDIATE_TX_MAX_ATTEMPTS) {
+        try {
+          db.exec("ROLLBACK");
+        } catch {}
+        sleepSyncMs(2 ** (attempt - 1));
+        continue;
+      }
+      throw err;
+    }
+    try {
+      const result = fn();
+      db.exec("COMMIT");
+      return result;
+    } catch (err) {
+      try {
+        db.exec("ROLLBACK");
+      } catch {}
+      throw err;
+    }
   }
+  throw lastBeginErr;
 }
 function upsertTaskHistory(db, row) {
   db.prepare(`
@@ -10074,6 +10099,7 @@ function upsertBodyEmbeddings(db, entries) {
     }
   })();
 }
+var WITH_IMMEDIATE_TX_MAX_ATTEMPTS = 5;
 var init_state_db = __esm(() => {
   init_managed_db();
   init_improve_types();
@@ -10327,7 +10353,7 @@ function pruneOldBackups(backupDir) {
 function getConfigLockPath() {
   return path7.join(getConfigDir(), "config.json.lck");
 }
-function sleepSyncMs(ms) {
+function sleepSyncMs2(ms) {
   sleepSync(ms);
 }
 function acquireConfigLock() {
@@ -10348,7 +10374,7 @@ function acquireConfigLock() {
       continue;
     }
     if (attempt < CONFIG_LOCK_MAX_RETRIES - 1) {
-      sleepSyncMs(CONFIG_LOCK_RETRY_DELAY_MS);
+      sleepSyncMs2(CONFIG_LOCK_RETRY_DELAY_MS);
     }
   }
   return () => {};
@@ -11241,9 +11267,7 @@ var init_profiles = __esm(() => {
 
 // src/integrations/agent/config.ts
 var init_config = __esm(() => {
-  init_config2();
   init_errors();
-  init_warn();
   init_profiles();
 });
 

package/dist/tasks/backends/cron.js

@@ -29,7 +29,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { ConfigError } from "../../core/errors.js";
 import { getTaskLogDir } from "../../core/paths.js";
-import { resolveAkmInvocation } from "../resolveAkmBin.js";
+import { resolveAkmInvocation } from "../resolve-akm-bin.js";
 import { parseSchedule, translateToCron } from "../schedule.js";
 const BEGIN = (id) => `# akm:task ${id} BEGIN`;
 const END = (id) => `# akm:task ${id} END`;

package/dist/tasks/backends/launchd.js

@@ -27,7 +27,7 @@ import path from "node:path";
 import launchdTemplate from "../../assets/backends/launchd-template.xml" with { type: "text" };
 import { ConfigError } from "../../core/errors.js";
 import { getTaskLogDir } from "../../core/paths.js";
-import { resolveAkmInvocation } from "../resolveAkmBin.js";
+import { resolveAkmInvocation } from "../resolve-akm-bin.js";
 import { parseSchedule, translateToLaunchd } from "../schedule.js";
 import { escapeXml, nodeExec, nodeFs } from "./exec-utils.js";
 export const LAUNCHD_LABEL_PREFIX = "com.akm.task.";

package/dist/tasks/backends/schtasks.js

@@ -35,7 +35,7 @@ import path from "node:path";
 import schtasksTemplate from "../../assets/backends/schtasks-template.xml" with { type: "text" };
 import { ConfigError } from "../../core/errors.js";
 import { getTaskLogDir } from "../../core/paths.js";
-import { resolveAkmInvocation } from "../resolveAkmBin.js";
+import { resolveAkmInvocation } from "../resolve-akm-bin.js";
 import { parseSchedule, translateToSchtasks } from "../schedule.js";
 import { escapeXml, nodeExec, nodeFs } from "./exec-utils.js";
 export const DEFAULT_FOLDER_PREFIX = "\\akm\\";

package/dist/tasks/{resolveAkmBin.js → resolve-akm-bin.js}

@@ -44,8 +44,8 @@ export function resolveAkmInvocation(options = {}) {
 /**
  * From the URL of a module inside `src/tasks/` figure out the CLI entry.
  *
- *   • dev      `…/src/tasks/resolveAkmBin.ts`   → `…/src/cli.ts`
- *   • build    `…/dist/tasks/resolveAkmBin.js`  → `…/dist/cli.js`
+ *   • dev      `…/src/tasks/resolve-akm-bin.ts`   → `…/src/cli.ts`
+ *   • build    `…/dist/tasks/resolve-akm-bin.js`  → `…/dist/cli.js`
  */
 function resolveCliEntry(moduleUrl) {
     let modulePath;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akm-cli",
-  "version": "0.9.0-beta.48",
+  "version": "0.9.0-beta.49",
   "type": "module",
   "description": "akm (Agent Knowledge Management) — A package manager for AI agent skills, commands, tools, and knowledge. Works with Claude Code, OpenCode, Cursor, and any AI coding assistant.",
   "keywords": [

package/dist/commands/improve/related-sessions.js

@@ -1,120 +0,0 @@
-// This Source Code Form is subject to the terms of the Mozilla Public
-// License, v. 2.0. If a copy of the MPL was not distributed with this
-// file, You can obtain one at https://mozilla.org/MPL/2.0/.
-/**
- * #627 — getRelatedSessions helper.
- *
- * Finds session assets related to a seed by SHARED TAGS / GRAPH ENTITIES —
- * NEVER embedding similarity. Modeled on recombine.ts buildRelatednessClusters:
- * two sessions relate when they share at least one *topic* tag or graph entity;
- * two textually near-identical sessions with no shared topic signal do NOT
- * relate. This makes the helper a pure query-layer relatedness lookup that
- * makes NO network / embedding calls.
- *
- * The generic base tags every session asset carries (`session` + the harness
- * id, see session-asset.ts) are IGNORED for relatedness — otherwise every
- * session would trivially relate to every other. Callers should therefore seed
- * with derived topic tags, but the helper defensively strips the generic base
- * tags from candidate sessions too.
- *
- * Relatedness source:
- *   - `"tags"`  — score by count of (seedTags ∩ session tags).
- *   - `"graph"` — score by count of (seedEntities ∩ session graph entities);
- *                 falls open to tag relatedness when the graph table is empty.
- *   - `"both"`  — sum of the tag + entity overlap.
- */
-import { makeAssetRef } from "../../core/asset/asset-ref.js";
-import { closeDatabase, getAllEntries, getEntitiesByEntryIds, openExistingDatabase, } from "../../indexer/db/db.js";
-/** Generic base tags every session asset carries — never a relatedness signal. */
-const GENERIC_SESSION_TAGS = new Set(["session"]);
-/**
- * Build the set of topic tags for a session entry, excluding generic base tags
- * (`session`) and the harness segment of the entry name (the harness id is the
- * first path component of `<harness>/<id>` and is also carried as a base tag).
- */
-function topicTagsForSession(entry) {
-    const harness = entry.entry.name.split("/")[0];
-    const result = new Set();
-    for (const tag of entry.entry.tags ?? []) {
-        if (GENERIC_SESSION_TAGS.has(tag))
-            continue;
-        if (harness && tag === harness)
-            continue;
-        result.add(tag);
-    }
-    return result;
-}
-/**
- * Find session assets related to a seed by shared tags / graph entities.
- * Relatedness is signal-based, NOT embedding similarity.
- */
-export function getRelatedSessions(opts) {
-    const seedTags = (opts.seedTags ?? [])
-        .filter((t) => !GENERIC_SESSION_TAGS.has(t))
-        .map((t) => t.trim())
-        .filter(Boolean);
-    const seedEntities = (opts.seedEntities ?? []).map((e) => e.trim().toLowerCase()).filter(Boolean);
-    const minShared = opts.minShared ?? 1;
-    const limit = opts.limit ?? 5;
-    const relatednessSource = opts.relatednessSource ?? "tags";
-    const excludeRefs = new Set(opts.excludeRefs ?? []);
-    // Empty seed input → nothing to relate to.
-    if (seedTags.length === 0 && seedEntities.length === 0)
-        return [];
-    const seedTagSet = new Set(seedTags);
-    const seedEntitySet = new Set(seedEntities);
-    let db = opts.db;
-    let ownsDb = false;
-    if (!db) {
-        db = openExistingDatabase();
-        ownsDb = true;
-    }
-    try {
-        const sessions = getAllEntries(db, "session");
-        // Resolve graph entities for the candidate sessions when requested. Fail
-        // open to tag relatedness when the graph table is empty (no rows).
-        let entityByEntryId;
-        const wantGraph = relatednessSource === "graph" || relatednessSource === "both";
-        if (wantGraph) {
-            try {
-                entityByEntryId = getEntitiesByEntryIds(db, sessions.map((s) => s.id));
-            }
-            catch {
-                entityByEntryId = undefined;
-            }
-        }
-        const hasEntities = !!entityByEntryId && entityByEntryId.size > 0;
-        // Effective signal selection. "graph" with no entities falls open to tags.
-        const useTags = relatednessSource === "tags" || relatednessSource === "both" || (wantGraph && !hasEntities);
-        const useGraph = wantGraph && hasEntities;
-        const scored = [];
-        for (const session of sessions) {
-            const ref = makeAssetRef(session.entry.type, session.entry.name);
-            if (excludeRefs.has(ref))
-                continue;
-            let sharedCount = 0;
-            if (useTags && seedTagSet.size > 0) {
-                for (const tag of topicTagsForSession(session)) {
-                    if (seedTagSet.has(tag))
-                        sharedCount += 1;
-                }
-            }
-            if (useGraph && seedEntitySet.size > 0 && entityByEntryId) {
-                for (const ent of entityByEntryId.get(session.id) ?? []) {
-                    if (seedEntitySet.has(ent))
-                        sharedCount += 1;
-                }
-            }
-            if (sharedCount >= minShared) {
-                scored.push({ ref, name: session.entry.name, sharedCount });
-            }
-        }
-        // Rank by shared-signal count desc, then ref for a deterministic tiebreak.
-        scored.sort((a, b) => b.sharedCount - a.sharedCount || a.ref.localeCompare(b.ref));
-        return scored.slice(0, Math.max(0, limit));
-    }
-    finally {
-        if (ownsDb && db)
-            closeDatabase(db);
-    }
-}

package/dist/commands/lint.js

@@ -1,4 +0,0 @@
-// This Source Code Form is subject to the terms of the Mozilla Public
-// License, v. 2.0. If a copy of the MPL was not distributed with this
-// file, You can obtain one at https://mozilla.org/MPL/2.0/.
-export { akmLint } from "./lint/index.js";