@oxygen-agent/cli 1.1003.12 → 1.1010.1

package/dist/search-ai-filter-notice.d.ts

@@ -0,0 +1,17 @@
+/**
+ * A charged search AI filter's run totals as one terminal line (ADR 0027,
+ * amendment 2026-09-25). `table-ingestions get` carries them under
+ * `ai_filter`; `table-ingestions wait` nests that response under
+ * `ingestionRun`. The blind baseline could not see what a filter kept and
+ * what it dropped, so the terminal says it next to the JSON.
+ *
+ * Matches and items the filter could not judge are both written to the table,
+ * so the line never sums them into one "kept": the blind acceptance
+ * (2026-09-25) read "kept 200, dropped 0" as 200 matches when 27 of them were
+ * never judged.
+ *
+ * Returns null unless the envelope carries run totals. The plan's and the dry
+ * run's `ai_filter` blocks are quotes without a `fetched` count, so they print
+ * nothing.
+ */
+export declare function formatSearchAiFilterTotalsNotice(data: unknown): string | null;

package/dist/search-ai-filter-notice.js

@@ -0,0 +1,38 @@
+import { isRecord } from "./util.js";
+/**
+ * A charged search AI filter's run totals as one terminal line (ADR 0027,
+ * amendment 2026-09-25). `table-ingestions get` carries them under
+ * `ai_filter`; `table-ingestions wait` nests that response under
+ * `ingestionRun`. The blind baseline could not see what a filter kept and
+ * what it dropped, so the terminal says it next to the JSON.
+ *
+ * Matches and items the filter could not judge are both written to the table,
+ * so the line never sums them into one "kept": the blind acceptance
+ * (2026-09-25) read "kept 200, dropped 0" as 200 matches when 27 of them were
+ * never judged.
+ *
+ * Returns null unless the envelope carries run totals. The plan's and the dry
+ * run's `ai_filter` blocks are quotes without a `fetched` count, so they print
+ * nothing.
+ */
+export function formatSearchAiFilterTotalsNotice(data) {
+    if (!isRecord(data))
+        return null;
+    const run = isRecord(data.ingestionRun) ? data.ingestionRun : data;
+    const totals = isRecord(run.ai_filter) ? run.ai_filter : null;
+    if (!totals || typeof totals.fetched !== "number")
+        return null;
+    const count = (value) => (typeof value === "number" && Number.isFinite(value) ? value : 0);
+    const matched = count(totals.kept_matched ?? totals.matched);
+    const unjudged = count(totals.kept_unjudged ?? totals.unclassified);
+    const credits = count(totals.credits_charged);
+    const parts = [
+        `${matched} matched`,
+        `${unjudged} could not be judged (kept, marked unclassified)`,
+        `${count(totals.dropped)} dropped`,
+    ];
+    const unavailable = typeof totals.unavailable_reason === "string" && totals.unavailable_reason
+        ? `. The filter did not run on some pages: ${totals.unavailable_reason}`
+        : "";
+    return `AI filter: fetched ${count(totals.fetched)}: ${parts.join(", ")}${credits > 0 ? `; ${credits} credits` : ""}${unavailable}`;
+}

package/dist/skills.js

@@ -793,27 +793,51 @@ function scoreSkill(skill, tokens, recommendedSkills) {
         score += 400 - (routeIndex * 20);
     return score;
 }
+/**
+ * Rank a skill's documents against the query tokens.
+ *
+ * An EXACT hit on a provider name, a path segment, or a tag outranks an
+ * incidental substring. Flat `includes` scoring made a query that literally
+ * names a provider lose to an unrelated document that merely contains the
+ * letters: measured 2026-09-21, `skills search "hubspot import segment
+ * do-not-contact suppression"` returned `provider-runbooks/bettercontact.md`
+ * and not `provider-runbooks/hubspot.md`, because "contact" is a substring of
+ * "bettercontact" and the alphabetical tie-break did the rest. A blind
+ * acceptance run lost its whole HubSpot fallback to that.
+ */
 function matchingSkillDocuments(skill, tokens) {
     if (tokens.length === 0)
         return [];
     return skill.documents
         .map((document) => ({
         document,
-        score: tokens.reduce((total, token) => {
-            const text = [
-                document.path,
-                document.title ?? "",
-                document.kind ?? "",
-                ...document.tags,
-                ...document.providers,
-            ].join(" ").toLowerCase();
-            return total + (text.includes(token) ? 1 : 0);
-        }, 0),
+        score: scoreSkillDocument(document, tokens),
     }))
         .filter((entry) => entry.score > 0)
         .sort((a, b) => b.score - a.score || a.document.path.localeCompare(b.document.path))
         .map((entry) => entry.document);
 }
+function scoreSkillDocument(document, tokens) {
+    const exact = new Set([
+        ...document.providers.map((value) => value.toLowerCase()),
+        ...document.tags.map((value) => value.toLowerCase()),
+        // Path segments without the extension: "provider-runbooks/hubspot.md" ->
+        // "provider", "runbooks", "hubspot".
+        ...document.path.toLowerCase().replace(/\.[a-z0-9]+$/, "").split(/[^a-z0-9]+/),
+    ].filter(Boolean));
+    const substring = [
+        document.path,
+        document.title ?? "",
+        document.kind ?? "",
+        ...document.tags,
+        ...document.providers,
+    ].join(" ").toLowerCase();
+    return tokens.reduce((total, token) => {
+        if (exact.has(token))
+            return total + 5;
+        return total + (substring.includes(token) ? 1 : 0);
+    }, 0);
+}
 function inspectSkillsInstaller() {
     const invocation = resolveCmdShimInvocation("npx", ["--version"], process.platform, process.env);
     const result = spawnSync(invocation.executable, invocation.args, {

package/dist/util.d.ts

@@ -1,3 +1,12 @@
 export { isRecord } from "@oxygen/shared";
 export declare function readOption(value: string | undefined): string | null;
+/**
+ * A flag whose ABSENCE and whose EMPTY value mean different things: absent
+ * leaves the field alone, `""` clears it. `readOption` folds both into `null`,
+ * which is how `crm tasks update --title x` used to send `priority: null,
+ * due_at: null, body: null, assignee_actor_id: null` and wipe a task's deadline
+ * and priority on every rename (dev, 2026-09-22) — and `crm notes update --pin`
+ * cleared the title the same way.
+ */
+export declare function readClearableOption(value: string | undefined): string | null | undefined;
 export declare function readErrorMessage(error: unknown): string;

package/dist/util.js

@@ -2,6 +2,20 @@ export { isRecord } from "@oxygen/shared";
 export function readOption(value) {
     return typeof value === "string" && value.trim() ? value.trim() : null;
 }
+/**
+ * A flag whose ABSENCE and whose EMPTY value mean different things: absent
+ * leaves the field alone, `""` clears it. `readOption` folds both into `null`,
+ * which is how `crm tasks update --title x` used to send `priority: null,
+ * due_at: null, body: null, assignee_actor_id: null` and wipe a task's deadline
+ * and priority on every rename (dev, 2026-09-22) — and `crm notes update --pin`
+ * cleared the title the same way.
+ */
+export function readClearableOption(value) {
+    if (value === undefined)
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed ? trimmed : null;
+}
 export function readErrorMessage(error) {
     return error instanceof Error ? error.message : "unknown error";
 }