akm-cli 0.9.0-beta.47 → 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-schema.js

@@ -22,8 +22,14 @@
  * - Two exceptions (hard-rejected): openviking source type and legacy
  *   `stashes[]` key. Both have explicit migration paths; silently dropping
  *   would mask user data loss.
- * - `.strict()` walls still gate `registries[]`, `sources[]`, `profiles.*`
- *   sub-shapes so typos in those structured records are caught (#462).
+ * - UNKNOWN-KEY POLICY: object schemas use passthrough (unknown keys are
+ *   preserved and ignored, NOT rejected). akm runs across multiple installed
+ *   versions sharing one config.json; a newer version writes keys an older
+ *   version's schema doesn't know yet, so hard-rejecting unknown keys turned
+ *   benign version skew into `INVALID_CONFIG_FILE` failures. Known keys are
+ *   still type-checked; passthrough preserves unknown keys across a
+ *   load→save round trip so an older reader never strips a newer writer's
+ *   settings. (Replaced the prior strict-mode object walls.)
  * - `defaultWriteTarget` resolution and similar cross-field invariants are
  *   enforced at save time via `superRefine` on the top-level schema.
  */
@@ -50,7 +56,7 @@ const LlmCapabilitiesSchema = z
     .object({
     structuredOutput: z.boolean().optional(),
 })
-    .strict();
+    .passthrough();
 /**
  * Connection config used for both top-level `llm` (after migration) and
  * `profiles.llm[*]`. `model` is required at schema level — partial entries
@@ -75,15 +81,15 @@ export const LlmConnectionConfigSchema = z
     judgeModel: z.string().min(1).optional(),
     enableThinking: z.boolean().optional(),
 })
-    .strict();
+    .passthrough();
 export const LlmProfileConfigSchema = LlmConnectionConfigSchema.extend({
     supportsJsonSchema: z.boolean().optional(),
-}).strict();
+}).passthrough();
 const EmbeddingOllamaOptionsSchema = z
     .object({
     num_ctx: positiveInt.optional(),
 })
-    .strict();
+    .passthrough();
 /**
  * Embedding connection config. Both `endpoint` and `model` are optional:
  *   - Remote: provide `endpoint` (http/https URL) + `model`.
@@ -107,7 +113,7 @@ export const EmbeddingConnectionConfigSchema = z
     contextLength: positiveInt.optional(),
     ollamaOptions: EmbeddingOllamaOptionsSchema.optional(),
 })
-    .strict();
+    .passthrough();
 // ── Agent profiles ──────────────────────────────────────────────────────────
 // Derives from the canonical VALID_HARNESS_IDS (#565) so the Zod gate cannot
 // drift from the TS union / parse check / setup detection.
@@ -120,7 +126,7 @@ export const AgentProfileConfigSchema = z
     workspace: z.string().min(1).optional(),
     model: z.string().min(1).optional(),
 })
-    .strict();
+    .passthrough();
 // ── Improve profile / process ──────────────────────────────────────────────
 export const ImproveProcessConfigSchema = z
     .object({
@@ -151,7 +157,7 @@ export const ImproveProcessConfigSchema = z
         // with care — cost is O(n²).
         cosineCandidateLimit: z.number().int().positive().optional(),
     })
-        .strict()
+        .passthrough()
         .optional(),
     // Consolidate process: judged-state cache (#581). When enabled, a memory
     // whose current content hash equals its cached judged hash is SKIPPED from
@@ -160,9 +166,9 @@ export const ImproveProcessConfigSchema = z
     // time-window slice. Default OFF — when absent the consolidate pass behaves
     // byte-identically to today (the incrementalSince path is unaffected). Only
     // meaningful on the `consolidate` process.
-    judgedCache: z.object({ enabled: z.boolean().optional() }).strict().optional(),
-    qualityGate: z.object({ enabled: z.boolean().optional() }).strict().optional(),
-    contradictionDetection: z.object({ enabled: z.boolean().optional() }).strict().optional(),
+    judgedCache: z.object({ enabled: z.boolean().optional() }).passthrough().optional(),
+    qualityGate: z.object({ enabled: z.boolean().optional() }).passthrough().optional(),
+    contradictionDetection: z.object({ enabled: z.boolean().optional() }).passthrough().optional(),
     // Extract process config (only meaningful for extract process)
     defaultSince: z.string().min(1).optional(),
     maxTotalChars: positiveInt.optional(),
@@ -236,7 +242,7 @@ export const ImproveProcessConfigSchema = z
         // Demotion factor: multiply retrievalSalience by this when stale (default 0.5).
         demotionFactor: z.number().min(0).max(1).optional(),
     })
-        .strict()
+        .passthrough()
         .optional(),
     // WS-3b: Schema-similarity gate (step 0b). At intake, if a new candidate's
     // body embedding is within epsilon of an existing derived-layer lesson/knowledge
@@ -253,7 +259,7 @@ export const ImproveProcessConfigSchema = z
         // to pass the quality gate and create redundant stash entries.
         confidencePenalty: z.number().min(0).max(1).optional(),
     })
-        .strict()
+        .passthrough()
         .optional(),
     // WS-3b: Hot-probation intake buffer (step 0c, #604). New system-generated
     // extractions enter captureMode: hot-probation and spend ONE consolidation
@@ -263,7 +269,7 @@ export const ImproveProcessConfigSchema = z
         .object({
         enabled: z.boolean().optional(),
     })
-        .strict()
+        .passthrough()
         .optional(),
     // WS-3b: Anti-collapse guards (step 8). Prevents the consolidation pipeline
     // from collapsing too aggressively and losing diversity.
@@ -278,7 +284,7 @@ export const ImproveProcessConfigSchema = z
         lexicalDiversityCheck: z.boolean().optional(),
         randomClusterFraction: z.number().min(0).max(1).optional(),
     })
-        .strict()
+        .passthrough()
         .optional(),
     // WS-3b: CLS (Complementary Learning System) interleaving (step 9).
     // distill/memoryInference prompts include embedding-retrieved existing adjacent
@@ -290,7 +296,7 @@ export const ImproveProcessConfigSchema = z
         // Number of adjacent lessons/knowledge to include in prompts (default 3).
         adjacentCount: z.number().int().min(1).optional(),
     })
-        .strict()
+        .passthrough()
         .optional(),
     // WS-3b: Distill→source fidelity check (step 10). After a distill proposal,
     // check it against its cited source memories; a contradiction flag forces
@@ -299,7 +305,7 @@ export const ImproveProcessConfigSchema = z
         .object({
         enabled: z.boolean().optional(),
     })
-        .strict()
+        .passthrough()
         .optional(),
     // #609 — recombine process: minimum related-memory cluster size before an
     // LLM generalization call. Default 3. Only meaningful on `recombine`.
@@ -342,7 +348,7 @@ export const ImproveProcessConfigSchema = z
     // enabled, proposals classified as "low-value" by the deterministic noise
     // gate are deferred. DEFAULT OFF (absent / { enabled: false } = pre-#639
     // byte-identical behaviour). Only meaningful on the `reflect` process.
-    lowValueFilter: z.object({ enabled: z.boolean().optional() }).strict().optional(),
+    lowValueFilter: z.object({ enabled: z.boolean().optional() }).passthrough().optional(),
     // #641 — procedural-aware floor for the `extract` process triage gate.
     // When true, a session must have markers>=1 OR editCommit>=0.5 to pass, even
     // if score>=minScore. DEFAULT OFF (absent/false = pre-#641 byte-identical).
@@ -360,10 +366,10 @@ export const ImproveProcessConfigSchema = z
         profile: z.string().min(1).optional(),
         timeoutMs: z.union([positiveInt, z.null()]).optional(),
     })
-        .strict()
+        .passthrough()
         .optional(),
 })
-    .strict();
+    .passthrough();
 const ImproveProfileProcessesSchema = z
     .object({
     reflect: ImproveProcessConfigSchema.optional(),
@@ -380,37 +386,17 @@ const ImproveProfileProcessesSchema = z
     .passthrough()
     .superRefine((val, ctx) => {
     // 0.8.0 removed the duplicated `feedbackDistillation` process key — it was
-    // a thin wrapper around `processes.distill.enabled`. Single source of truth.
-    const raw = val;
-    if ("feedbackDistillation" in raw) {
+    // a thin wrapper around `processes.distill.enabled`. Keep the migration
+    // hint so a stale config gets an actionable message rather than silently
+    // doing nothing. All OTHER unknown process keys are tolerated (passthrough)
+    // — see the unknown-key policy in this file's header. Hard-rejecting them
+    // turned benign cross-version skew into INVALID_CONFIG_FILE failures.
+    if ("feedbackDistillation" in val) {
         ctx.addIssue({
             code: z.ZodIssueCode.custom,
             message: "feedbackDistillation was removed in 0.8.0 — use processes.distill.enabled instead. " +
                 "It now controls both the orchestration gate and the LLM-call gate.",
         });
-        return;
-    }
-    const allowed = new Set([
-        "reflect",
-        "distill",
-        "consolidate",
-        "memoryInference",
-        "graphExtraction",
-        "validation",
-        "extract",
-        "triage",
-        "proactiveMaintenance",
-        "recombine",
-        "procedural",
-    ]);
-    for (const k of Object.keys(raw)) {
-        if (!allowed.has(k)) {
-            ctx.addIssue({
-                code: z.ZodIssueCode.unrecognized_keys,
-                keys: [k],
-                message: `Unrecognized improve process key: "${k}".`,
-            });
-        }
     }
 });
 export const ImproveProfileConfigSchema = z
@@ -435,10 +421,10 @@ export const ImproveProfileConfigSchema = z
         push: z.boolean().optional(),
         message: z.string().min(1).optional(),
     })
-        .strict()
+        .passthrough()
         .optional(),
 })
-    .strict();
+    .passthrough();
 // ── Profiles / defaults ────────────────────────────────────────────────────
 export const ProfilesSchema = z
     .object({
@@ -446,14 +432,14 @@ export const ProfilesSchema = z
     agent: z.record(z.string(), AgentProfileConfigSchema).optional(),
     improve: z.record(z.string(), ImproveProfileConfigSchema).optional(),
 })
-    .strict();
+    .passthrough();
 export const DefaultsSchema = z
     .object({
     llm: z.string().min(1).optional(),
     agent: z.string().min(1).optional(),
     improve: z.string().min(1).optional(),
 })
-    .strict();
+    .passthrough();
 // ── Sources / registries / installed ────────────────────────────────────────
 const SourceConfigEntryOptionsSchema = z
     .object({
@@ -477,7 +463,7 @@ export const SourceConfigEntrySchema = z
     options: SourceConfigEntryOptionsSchema.optional(),
     wikiName: z.string().min(1).optional(),
 })
-    .strict()
+    .passthrough()
     .superRefine((entry, ctx) => {
     if (entry.writable === true && (entry.type === "website" || entry.type === "npm")) {
         ctx.addIssue({
@@ -496,7 +482,7 @@ export const RegistryConfigEntrySchema = z
     provider: z.string().min(1).optional(),
     options: z.record(z.unknown()).optional(),
 })
-    .strict();
+    .passthrough();
 const KitSourceSchema = z.enum(["filesystem", "git", "npm", "github", "website", "local"]);
 export const InstalledStashEntrySchema = z
     .object({
@@ -512,7 +498,7 @@ export const InstalledStashEntrySchema = z
     resolvedRevision: z.string().min(1).optional(),
     wikiName: z.string().min(1).optional(),
 })
-    .strict()
+    .passthrough()
     .superRefine((entry, ctx) => {
     if (entry.writable === true && entry.source !== "git" && entry.source !== "filesystem") {
         ctx.addIssue({
@@ -527,7 +513,7 @@ export const OutputConfigSchema = z
     format: z.enum(["json", "yaml", "text"]).optional(),
     detail: z.enum(["brief", "normal", "full"]).optional(),
 })
-    .strict();
+    .passthrough();
 // ── Search ──────────────────────────────────────────────────────────────────
 const SearchGraphBoostSchema = z
     .object({
@@ -541,29 +527,29 @@ const SearchGraphBoostSchema = z
     /** Range [0, 1]; values > 1 hard-error (no silent clamp). */
     confidenceWeight: z.number().finite().min(0).max(1).default(0.2).optional(),
 })
-    .strict();
+    .passthrough();
 export const SearchConfigSchema = z
     .object({
     minScore: nonNegativeNumber.optional(),
     defaultExcludeTypes: z.array(nonEmptyString).optional(),
-    curateRerank: z.object({ enabled: z.boolean().optional() }).strict().optional(),
+    curateRerank: z.object({ enabled: z.boolean().optional() }).passthrough().optional(),
     graphBoost: SearchGraphBoostSchema.optional(),
 })
-    .strict();
+    .passthrough();
 // ── Feedback ────────────────────────────────────────────────────────────────
 export const FeedbackConfigSchema = z
     .object({
     requireReason: z.boolean().optional(),
     allowedFailureModes: z.array(nonEmptyString).optional(),
 })
-    .strict();
+    .passthrough();
 // ── Improve top-level (utility decay, event retention) ─────────────────────
 const ImproveUtilityDecaySchema = z
     .object({
     halfLifeDays: z.number().finite().min(0.1).optional(),
     feedbackStabilityBoost: z.number().finite().min(1).optional(),
 })
-    .strict();
+    .passthrough();
 // #612 / WS-4 — auto-accept gate calibration + bounded, opt-in per-phase
 // threshold auto-tune. DEFAULT OFF: when absent (or `autoTune: false`) no
 // tuning occurs, so the gate behaves byte-identically to today.
@@ -586,7 +572,7 @@ const ImproveCalibrationSchema = z
     /** Target realized accept rate in [0, 1]. Default 0.9. */
     targetAcceptRate: z.number().finite().min(0).max(1).optional(),
 })
-    .strict();
+    .passthrough();
 // WS-4 — exploration budget: a fixed fraction of proposals accepted per run
 // regardless of confidence. DEFAULT OFF.
 const ImproveExplorationSchema = z
@@ -602,7 +588,7 @@ const ImproveExplorationSchema = z
      */
     budgetFraction: z.number().finite().min(0).max(1).optional(),
 })
-    .strict();
+    .passthrough();
 const ImproveSalienceSchema = z
     .object({
     /**
@@ -624,7 +610,7 @@ const ImproveSalienceSchema = z
      */
     replayBudget: z.number().int().min(0).optional(),
 })
-    .strict();
+    .passthrough();
 export const ImproveConfigSchema = z
     .object({
     utilityDecay: ImproveUtilityDecaySchema.optional(),
@@ -633,7 +619,7 @@ export const ImproveConfigSchema = z
     exploration: ImproveExplorationSchema.optional(),
     salience: ImproveSalienceSchema.optional(),
 })
-    .strict();
+    .passthrough();
 // ── Index / per-pass ────────────────────────────────────────────────────────
 const GRAPH_EXTRACTION_INCLUDE_TYPES_ALLOWED = [
     "memory",
@@ -712,13 +698,13 @@ export const IndexPassConfigSchema = z.preprocess((raw, ctx) => {
     lazyGraphExtraction: z.boolean().optional(),
 })
     .passthrough());
-const MetadataEnhanceSchema = z.object({ enabled: z.boolean().optional() }).strict();
+const MetadataEnhanceSchema = z.object({ enabled: z.boolean().optional() }).passthrough();
 const StalenessDetectionSchema = z
     .object({
     enabled: z.boolean().optional(),
     thresholdDays: positiveInt.optional(),
 })
-    .strict();
+    .passthrough();
 /**
  * Index config is a union of reserved feature sections and per-pass entries.
  * Passthrough so per-pass entries (keyed by arbitrary pass names like `graph`,
@@ -791,12 +777,12 @@ export const SetupTaskSchedulesSchema = z
     improve: z.string().min(1).optional(),
     index: z.string().min(1).optional(),
 })
-    .strict();
+    .passthrough();
 export const SetupConfigSchema = z
     .object({
     taskSchedules: SetupTaskSchedulesSchema.optional(),
 })
-    .strict();
+    .passthrough();
 // ── Top-level AkmConfig ────────────────────────────────────────────────────
 /**
  * Base object schema used both as the top-level shape and as the source of
@@ -828,7 +814,7 @@ export const AkmConfigShape = {
     improve: ImproveConfigSchema.optional(),
     setup: SetupConfigSchema.optional(),
 };
-export const AkmConfigBaseSchema = z.object(AkmConfigShape).strict();
+export const AkmConfigBaseSchema = z.object(AkmConfigShape).passthrough();
 export const AkmConfigSchema = AkmConfigBaseSchema.superRefine((config, ctx) => {
     // #464.a: defaultWriteTarget must name a configured source when sources
     // are present. With no sources configured, error out instead of silently

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;
-}