akm-cli 0.9.17-alpha.6 → 0.9.17-alpha.7

package/dist/core/adapter/adapters/akm-task-adapter.js

@@ -17,11 +17,9 @@
  * ── validate (spec §6 task validation column) ──
  *
  * Validation enters the canonical task source parser (`parseTaskSource`,
- * task source v4 native as of P4 — a `version: 3` or `version: 2` document
- * is auto-read through the in-memory migration shim in
- * `parse-task-source.ts`; only a version the shim's deterministic planners
- * cannot convert, or any other unsupported number, fails closed with
- * `TASK_SCHEMA_VERSION_UNSUPPORTED`). That parser owns the closed key sets,
+ * which reads only task source v4 — a `version: 2` or `version: 3`
+ * document fails closed with `TASK_SCHEMA_VERSION_UNSUPPORTED`, naming
+ * `akm migrate apply`, which converts it). That parser owns the closed key sets,
  * the executable-selector XOR, hostile YAML policy, the `akm/command`
  * builtin, bounds, and physical `working-directory` containment. The
  * adapter only translates a parser failure into the format-family
@@ -33,7 +31,8 @@
  */
 import fs from "node:fs";
 import path from "node:path";
-import { parseTaskSource } from "../../../tasks/source/parse-task-source.js";
+import { readBoundedTaskSourceYaml } from "../../../tasks/source/bounded-document.js";
+import { parseTaskSource, peekTaskSourceVersion } from "../../../tasks/source/parse-task-source.js";
 import { TASK_EXTENSION, TASK_NEAR_MISS_EXTENSION, taskExtensionDetail, taskSourceErrorDetail, } from "../../../tasks/source-v3.js";
 import { toPosix } from "../../common.js";
 import { hashContent } from "./shared.js";
@@ -125,8 +124,11 @@ export const akmTaskAdapter = {
         return ["."];
     },
     /**
-     * Install-time probe (§1.2): a root holding a top-level, valid task-v3
-     * `.yml` file. The full parser keeps this disjoint from unrelated YAML and
+     * Install-time probe (§1.2): a root holding a top-level, valid task source
+     * v4 `.yml` file, or a task v2/v3 file that `akm migrate apply` has yet to
+     * convert (the runtime refuses those, so without this the migrator and
+     * `akm task sync` would not find them in a bundle whose adapter config does
+     * not record). The full parser keeps this disjoint from unrelated YAML and
      * prevents probe semantics from drifting from validation semantics.
      */
     looksLikeRoot(root) {
@@ -152,9 +154,28 @@ export const akmTaskAdapter = {
                 return true;
             }
             catch {
+                if (isLegacyTaskDocument(raw, entry.name))
+                    return true;
                 // Continue probing the remaining top-level .yml files.
             }
         }
         return false;
     },
 };
+/** The executable keys each retired task schema version required one of. */
+const LEGACY_TASK_TARGET_KEYS = {
+    2: ["workflow", "prompt", "command"],
+    3: ["uses", "run"],
+};
+/** A task v2/v3 document: its schema version, plus a target key that version used. */
+function isLegacyTaskDocument(yaml, filePath) {
+    let root;
+    try {
+        root = readBoundedTaskSourceYaml({ yaml, filePath }, { sourceLabel: "task source" }).root;
+    }
+    catch {
+        return false;
+    }
+    const keys = LEGACY_TASK_TARGET_KEYS[peekTaskSourceVersion(root) ?? 0];
+    return keys !== undefined && keys.some((key) => Object.hasOwn(root, key));
+}

package/dist/core/improve-result.js

@@ -306,6 +306,8 @@ function validateImprovePlan(value, dryRun, plannedRefNames) {
         fail("plan.limits.totalCeiling must equal plan.limits.effective + plan.limits.additiveReplayAllowance");
     }
     const gateNames = new Set(["profile", "cleanup", "validation", "signal", "disk", "limit"]);
+    // Plans stored before 0.9.17-alpha.7 (#986) have no retrieval gate.
+    const optionalGateNames = new Set(["retrieval"]);
     if (!Array.isArray(value.gates))
         fail("plan.gates must be an array");
     const gateRemovedByName = new Map();
@@ -313,8 +315,9 @@ function validateImprovePlan(value, dryRun, plannedRefNames) {
         if (!isRecord(gate))
             fail("plan.gates entries must be objects");
         requireExactFields(gate, new Set(["name", "removed", "reason"]));
-        if (typeof gate.name !== "string" || !gateNames.has(gate.name))
+        if (typeof gate.name !== "string" || !(gateNames.has(gate.name) || optionalGateNames.has(gate.name))) {
             fail("plan.gates.name is invalid");
+        }
         requireCount(gate, "removed", "plan.gates entry");
         if (typeof gate.reason !== "string")
             fail("plan.gates.reason must be a string");

package/dist/core/non-task-input.js

@@ -0,0 +1,20 @@
+// 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/.
+/** The line of `src/assets/stash-skeleton/README.md` that reaches curate verbatim as a query. */
+const STASH_README_LINE = "This is an **AKM stash** — a structured knowledge repository that stores reusable";
+/**
+ * What the (trimmed) curate input is when it is not a task, else undefined.
+ * Harness and tool envelopes (`<task-notification>…`, `<system-reminder>…`,
+ * `<cross-session-message …>…`) start with a tag and close one, and the stash
+ * README line arrives verbatim; on the retrieval suite neither shape occurs in
+ * a real query. Length is not a signal: prompts over 2,000 characters found
+ * relevant assets at about the rate of shorter long prompts.
+ */
+export function nonTaskInput(query) {
+    if (query.startsWith("<") && query.includes("</"))
+        return "a harness or tool envelope";
+    if (query === STASH_README_LINE)
+        return "the akm stash README boilerplate";
+    return undefined;
+}

package/dist/core/paths.js

@@ -249,10 +249,6 @@ export function getIndexRebuildLockPath() {
 export function getStateDbPathInDataDir() {
     return path.join(getDataDir(), "state.db");
 }
-/** Content-addressed scheduler runtime descriptors. */
-export function getTaskContextDir(env = process.env) {
-    return path.join(getDataDir(env), "tasks", "context");
-}
 /** Path to the akm.lock file in $DATA. */
 export function getLockfilePath() {
     return path.join(getDataDir(), "akm.lock");

package/dist/indexer/indexer.js

@@ -35,7 +35,7 @@ import { generateEmbeddingsForDb } from "./materialize-embeddings.js";
 import { canUseIncrementalSkip, computeDirFingerprint, getCachedDirState, getDirIndexState, inferZeroRowReason, } from "./passes/dir-staleness.js";
 import { isEnrichmentComplete, isWorkflowSkipWarning, withFileSize, } from "./passes/metadata.js";
 import { drainDirDocuments } from "./scan/drain-dir.js";
-import { purgeOldUsageEvents } from "./usage/usage-events.js";
+import { purgeOldUsageEvents, USAGE_EVENT_RETENTION_DAYS } from "./usage/usage-events.js";
 import { walkStashFlatWithStatus } from "./walk/walker.js";
 function collectLoweringNotices(target, notices) {
     const keys = new Set(target.map((notice) => JSON.stringify(notice)));
@@ -1624,8 +1624,6 @@ export async function lookup(ref) {
     return lookupBundleRef({ bundle: ref.origin, conceptId: conceptIdFromTypeName(ref.type, ref.name) });
 }
 // ── Utility score recomputation ──────────────────────────────────────────────
-/** Retention window for usage events: events older than this are purged. */
-const USAGE_EVENT_RETENTION_DAYS = 90;
 /**
  * Recompute utility scores for all entries based on usage_events data.
  *

package/dist/indexer/usage/usage-events.js

@@ -91,6 +91,40 @@ export function countUsageEventsByType(db, eventType) {
     return db.prepare("SELECT COUNT(*) AS cnt FROM usage_events WHERE event_type = ?").get(eventType)
         .cnt;
 }
+/**
+ * Durable refs a user-attributed `search`, `curate` or `show` returned, or a
+ * user `feedback` named, at or after `sinceIso`. Machine traffic (`improve`,
+ * `task`, `audit`, `unknown`) is not demand, as in {@link countFeedbackSignals}.
+ */
+export function listUsedEntryRefs(db, sinceIso) {
+    const rows = db
+        .prepare(`SELECT DISTINCT entry_ref FROM usage_events
+       WHERE event_type IN ('search', 'curate', 'show', 'feedback')
+         AND source = 'user'
+         AND entry_ref IS NOT NULL
+         AND julianday(created_at) >= julianday(?)`)
+        .all(sinceIso);
+    return rows.map((row) => row.entry_ref);
+}
+/**
+ * The distinct query texts of user `search` and `curate` events that returned
+ * `conceptId` (any bundle prefix), most recent first.
+ */
+export function listRetrievalQueries(db, conceptId) {
+    const rows = db
+        .prepare(`SELECT query, MAX(created_at) AS last_at FROM usage_events
+       WHERE event_type IN ('search', 'curate')
+         AND source = 'user'
+         AND query IS NOT NULL AND trim(query) != ''
+         AND instr(entry_ref, '//') > 0
+         AND substr(entry_ref, instr(entry_ref, '//') + 2) = ?
+       GROUP BY query
+       ORDER BY last_at DESC`)
+        .all(conceptId);
+    return rows.map((row) => row.query);
+}
+/** Usage events older than this many days are purged on every `akm index`. */
+export const USAGE_EVENT_RETENTION_DAYS = 90;
 /**
  * Delete usage events older than the given number of days.
  */