akm-cli 0.9.0-rc.0 → 0.9.0-rc.13

package/dist/output/renderers.js

@@ -13,10 +13,8 @@ import fs from "node:fs";
 import path from "node:path";
 import { listKeys as listVaultKeys } from "../commands/env/env.js";
 import { parseFrontmatter } from "../core/asset/frontmatter.js";
-import { extractFrontmatterOnly, extractLineRange, extractSection, formatToc, parseMarkdownToc, } from "../core/asset/markdown.js";
 import { asNonEmptyString, hasErrnoCode } from "../core/common.js";
-import { extractCommentMetadata, extractDescriptionFromComments } from "../indexer/passes/metadata.js";
-import { registerMetadataContributor } from "../indexer/passes/metadata-contributors.js";
+import { extractCommentMetadata } from "../indexer/passes/metadata.js";
 import { registerRenderer } from "../indexer/walk/file-context.js";
 import { buildWorkflowAction, workflowMdRenderer } from "../workflows/renderer.js";
 // ── Interpreter auto-detection map ───────────────────────────────────────────
@@ -219,60 +217,20 @@ const agentMdRenderer = {
         };
     },
 };
-// ── 4. knowledge-md / wiki-md shared helper ───────────────────────────────────
-const KNOWLEDGE_ACTION = "Reference material - read the content below. Use 'toc' view for large documents.";
-const WIKI_PAGE_ACTION = "Wiki page — read below. Use 'toc' to scan, 'section <heading>' for depth.";
-/**
- * Shared implementation for knowledge-md and wiki-md `buildShowResponse`.
- *
- * Both renderers handle the same set of view modes (toc, frontmatter, section,
- * lines, full). The only differences are the `type` discriminant and the
- * section-not-found message. Extracting this helper eliminates ~90 lines of
- * byte-for-byte duplication.
- */
-function buildMarkdownViewResponse(ctx, type, action) {
-    const name = deriveName(ctx);
-    const v = ctx.matchResult.meta?.view ?? { mode: "full" };
-    const content = ctx.content();
-    switch (v.mode) {
-        case "toc": {
-            const toc = parseMarkdownToc(content);
-            return { type, name, path: ctx.absPath, action, content: formatToc(toc) };
-        }
-        case "frontmatter": {
-            const fm = extractFrontmatterOnly(content);
-            return { type, name, path: ctx.absPath, action, content: fm ?? "(no frontmatter)" };
-        }
-        case "section": {
-            const section = extractSection(content, v.heading);
-            if (!section) {
-                const notFoundMsg = type === "wiki"
-                    ? `Section "${v.heading}" not found in ${name}. Try \`akm show wiki:${name} toc\` to discover available headings.`
-                    : `Section "${v.heading}" not found in ${name}. Try \`akm show <ref> toc\` to discover available headings.`;
-                return { type, name, path: ctx.absPath, action, content: notFoundMsg };
-            }
-            return { type, name, path: ctx.absPath, action, content: section.content };
-        }
-        case "lines": {
-            return { type, name, path: ctx.absPath, action, content: extractLineRange(content, v.start, v.end) };
-        }
-        default: {
-            return { type, name, path: ctx.absPath, action, content };
-        }
-    }
-}
 // ── 4. knowledge-md ──────────────────────────────────────────────────────────
+const KNOWLEDGE_ACTION = "Reference material - read the content below. For a large document, read one section with `akm show <ref>#fragment` " +
+    "(an unmatched #fragment lists the available slugs).";
 const knowledgeMdRenderer = {
     name: "knowledge-md",
     buildShowResponse(ctx) {
-        return buildMarkdownViewResponse(ctx, "knowledge", KNOWLEDGE_ACTION);
-    },
-};
-// ── 4b. wiki-md ──────────────────────────────────────────────────────────────
-const wikiMdRenderer = {
-    name: "wiki-md",
-    buildShowResponse(ctx) {
-        return buildMarkdownViewResponse(ctx, "wiki", WIKI_PAGE_ACTION);
+        const instruction = ctx.matchResult.type === "instruction";
+        return {
+            type: instruction ? "instruction" : "knowledge",
+            name: deriveName(ctx),
+            path: ctx.absPath,
+            action: instruction ? "Project instructions — read and follow the content below." : KNOWLEDGE_ACTION,
+            content: ctx.content(),
+        };
     },
 };
 // ── 4c. lesson-md ────────────────────────────────────────────────────────────
@@ -405,12 +363,12 @@ const secretFileRenderer = {
             type: "secret",
             name,
             path: ctx.absPath,
-            action: "Secret — name only; the file contents are the value and are never written to akm's stdout. Use `akm secret path <ref>` for the file path, or `akm secret run <ref> <VAR> -- <command>` to run with the value injected into $VAR.",
+            action: "Secret — name only; the file contents are the value and are never written to akm's stdout. Use `akm secret run <ref> <VAR> -- <command>` to run with the value injected into $VAR.",
         };
     },
 };
 // ── 7. task-md ───────────────────────────────────────────────────────────────
-const TASK_PAGE_ACTION = "Scheduled task — `akm tasks show <id>` for parsed details, `akm tasks run <id>` to invoke now.";
+const TASK_PAGE_ACTION = "Scheduled task — `akm show tasks/<id>` for parsed details, `akm task run <id>` to invoke now.";
 const taskMdRenderer = {
     name: "task-yaml",
     buildShowResponse(ctx) {
@@ -508,228 +466,6 @@ const factMdRenderer = {
         };
     },
 };
-function applySessionMetadata(entry, ctx) {
-    try {
-        const fm = applyFrontmatterDescriptionAndTags(entry, ctx);
-        entry.tags = Array.from(new Set([...(entry.tags ?? []), "session"]));
-        const hints = new Set(entry.searchHints ?? []);
-        const harness = asNonEmptyString(fm.harness);
-        if (harness)
-            hints.add(`harness:${harness}`);
-        const project = asNonEmptyString(fm.project);
-        if (project)
-            hints.add(`project:${project}`);
-        // log_path is the durable correlation key — keep it discoverable as a hint
-        // so it survives in the index even when the body is re-derived.
-        const logPath = asNonEmptyString(fm.log_path);
-        if (logPath)
-            hints.add(`log_path:${logPath}`);
-        if (hints.size > 0)
-            entry.searchHints = Array.from(hints).filter(Boolean);
-    }
-    catch {
-        // Non-fatal: skip metadata extraction on parse error
-    }
-}
-function applyTocMetadata(entry, ctx) {
-    try {
-        const toc = parseMarkdownToc(ctx.content());
-        if (toc.headings.length > 0)
-            entry.toc = toc.headings;
-    }
-    catch {
-        // Non-fatal: skip TOC if file can't be read
-    }
-}
-/**
- * Fact metadata: surface `category` and the `pinned` core marker as tags +
- * search hints (no dedicated DB columns — same encoding pattern as session /
- * task). `pinned` is mirrored to both a `pinned` tag and a `pinned` search
- * hint so the ranking contributor can detect it and queries can target it.
- */
-function applyFactMetadata(entry, ctx) {
-    try {
-        const fm = applyFrontmatterDescriptionAndTags(entry, ctx);
-        const tags = new Set([...(entry.tags ?? []), "fact"]);
-        const hints = new Set(entry.searchHints ?? []);
-        const category = asNonEmptyString(fm.category);
-        if (category) {
-            tags.add(category);
-            hints.add(`category:${category}`);
-        }
-        if (fm.pinned === true) {
-            tags.add("pinned");
-            hints.add("pinned");
-        }
-        entry.tags = Array.from(tags).filter(Boolean);
-        if (hints.size > 0)
-            entry.searchHints = Array.from(hints).filter(Boolean);
-    }
-    catch {
-        // Non-fatal: skip metadata extraction on parse error
-    }
-}
-/**
- * Parse frontmatter, apply description (if not already set) and merge tags
- * into `entry`. Returns the raw frontmatter data object so callers can access
- * type-specific fields without re-parsing.
- */
-function applyFrontmatterDescriptionAndTags(entry, ctx) {
-    const parsed = parseFrontmatter(ctx.content());
-    const fm = parsed.data;
-    const desc = asNonEmptyString(fm.description);
-    if (desc && !entry.description) {
-        entry.description = desc;
-        entry.source = "frontmatter";
-        entry.confidence = 0.9;
-    }
-    if (Array.isArray(fm.tags) && fm.tags.length > 0) {
-        const fmTags = fm.tags.filter((t) => typeof t === "string" && t.trim().length > 0);
-        if (fmTags.length > 0) {
-            entry.tags = Array.from(new Set([...(entry.tags ?? []), ...fmTags]));
-        }
-    }
-    return fm;
-}
-function applyLessonMetadata(entry, ctx) {
-    try {
-        const fm = applyFrontmatterDescriptionAndTags(entry, ctx);
-        const whenToUse = asNonEmptyString(fm.when_to_use);
-        if (whenToUse) {
-            const hints = new Set(entry.searchHints ?? []);
-            hints.add(`when_to_use:${whenToUse}`);
-            entry.searchHints = Array.from(hints).filter(Boolean);
-        }
-    }
-    catch {
-        // Non-fatal: skip metadata extraction on parse error
-    }
-}
-function applyMemoryMetadata(entry, ctx) {
-    try {
-        const fm = applyFrontmatterDescriptionAndTags(entry, ctx);
-        const hints = new Set(entry.searchHints ?? []);
-        const source = asNonEmptyString(fm.source);
-        if (source)
-            hints.add(source);
-        const fmObservedAt = asNonEmptyString(fm.observed_at);
-        if (fmObservedAt) {
-            hints.add(`observed_at:${fmObservedAt}`);
-        }
-        else {
-            try {
-                const isoDate = ctx.stat().mtime.toISOString().slice(0, 10);
-                hints.add(`observed_at:${isoDate}`);
-            }
-            catch {
-                // Non-fatal: skip mtime fallback on stat error
-            }
-        }
-        const expires = asNonEmptyString(fm.expires);
-        if (expires)
-            hints.add(`expires:${expires}`);
-        if (fm.subjective === true)
-            hints.add("subjective");
-        if (hints.size > 0) {
-            entry.searchHints = Array.from(hints).filter(Boolean);
-        }
-    }
-    catch {
-        // Non-fatal: skip metadata extraction on error
-    }
-}
-function applyScriptMetadata(entry, ctx) {
-    if (ctx.ext === ".md")
-        return;
-    const commentDesc = extractDescriptionFromComments(ctx.absPath);
-    if (commentDesc && !entry.description) {
-        entry.description = commentDesc;
-        entry.source = "comments";
-        entry.confidence = 0.7;
-    }
-}
-function applyEnvMetadata(entry, ctx) {
-    // Key names only — comment text must never reach description/search_text
-    // (comments routinely contain commented-out credentials).
-    const { keys } = listVaultKeys(ctx.absPath);
-    if (keys.length > 0) {
-        entry.searchHints = keys;
-    }
-    entry.tags = Array.from(new Set([...(entry.tags ?? []), "env", "secrets"]));
-}
-/**
- * Secret metadata: tags only. Must NEVER read the file body — the whole file
- * is the value, so the entry is built from the filename alone (name-only).
- */
-function applySecretMetadata(entry, _ctx) {
-    entry.tags = Array.from(new Set([...(entry.tags ?? []), "secret", "sensitive"]));
-}
-function applyTaskMetadata(entry, ctx) {
-    try {
-        const fm = applyFrontmatterDescriptionAndTags(entry, ctx);
-        entry.tags = Array.from(new Set([...(entry.tags ?? []), "task", "scheduled"]));
-        const hints = new Set(entry.searchHints ?? []);
-        const schedule = asNonEmptyString(fm.schedule);
-        if (schedule)
-            hints.add(`schedule:${schedule}`);
-        const workflow = asNonEmptyString(fm.workflow);
-        if (workflow)
-            hints.add(`workflow:${workflow}`);
-        const prompt = asNonEmptyString(fm.prompt);
-        if (prompt)
-            hints.add(`prompt:${prompt}`);
-        if (hints.size > 0)
-            entry.searchHints = Array.from(hints).filter(Boolean);
-    }
-    catch {
-        // Non-fatal: skip metadata extraction on error
-    }
-}
-registerMetadataContributor({
-    name: "toc-metadata",
-    appliesTo: ({ rendererName }) => rendererName === "knowledge-md" || rendererName === "wiki-md",
-    contribute: (entry, ctx) => applyTocMetadata(entry, ctx.renderContext),
-});
-registerMetadataContributor({
-    name: "lesson-frontmatter-metadata",
-    appliesTo: ({ rendererName }) => rendererName === "lesson-md",
-    contribute: (entry, ctx) => applyLessonMetadata(entry, ctx.renderContext),
-});
-registerMetadataContributor({
-    name: "memory-frontmatter-metadata",
-    appliesTo: ({ rendererName }) => rendererName === "memory-md",
-    contribute: (entry, ctx) => applyMemoryMetadata(entry, ctx.renderContext),
-});
-registerMetadataContributor({
-    name: "script-comment-metadata",
-    appliesTo: ({ rendererName }) => rendererName === "script-source",
-    contribute: (entry, ctx) => applyScriptMetadata(entry, ctx.renderContext),
-});
-registerMetadataContributor({
-    name: "env-file-metadata",
-    appliesTo: ({ rendererName }) => rendererName === "env-file",
-    contribute: (entry, ctx) => applyEnvMetadata(entry, ctx.renderContext),
-});
-registerMetadataContributor({
-    name: "secret-file-metadata",
-    appliesTo: ({ rendererName }) => rendererName === "secret-file",
-    contribute: (entry, ctx) => applySecretMetadata(entry, ctx.renderContext),
-});
-registerMetadataContributor({
-    name: "task-yaml-metadata",
-    appliesTo: ({ rendererName }) => rendererName === "task-yaml",
-    contribute: (entry, ctx) => applyTaskMetadata(entry, ctx.renderContext),
-});
-registerMetadataContributor({
-    name: "session-md-metadata",
-    appliesTo: ({ rendererName }) => rendererName === "session-md",
-    contribute: (entry, ctx) => applySessionMetadata(entry, ctx.renderContext),
-});
-registerMetadataContributor({
-    name: "fact-md-metadata",
-    appliesTo: ({ rendererName }) => rendererName === "fact-md",
-    contribute: (entry, ctx) => applyFactMetadata(entry, ctx.renderContext),
-});
 // ── Registration ─────────────────────────────────────────────────────────────
 /** All built-in renderers. */
 const builtinRenderers = [
@@ -737,7 +473,6 @@ const builtinRenderers = [
     commandMdRenderer,
     agentMdRenderer,
     knowledgeMdRenderer,
-    wikiMdRenderer,
     lessonMdRenderer,
     memoryMdRenderer,
     workflowMdRenderer,
@@ -758,4 +493,4 @@ export function registerBuiltinRenderers() {
     }
 }
 // ── Named exports for testing ────────────────────────────────────────────────
-export { agentMdRenderer, commandMdRenderer, envFileRenderer, factMdRenderer, INTERPRETER_MAP, knowledgeMdRenderer, lessonMdRenderer, memoryMdRenderer, SETUP_SIGNALS, scriptSourceRenderer, secretFileRenderer, skillMdRenderer, wikiMdRenderer, workflowMdRenderer, };
+export { agentMdRenderer, commandMdRenderer, envFileRenderer, factMdRenderer, INTERPRETER_MAP, knowledgeMdRenderer, lessonMdRenderer, memoryMdRenderer, SETUP_SIGNALS, scriptSourceRenderer, secretFileRenderer, skillMdRenderer, workflowMdRenderer, };

package/dist/output/shapes/curate.js

@@ -11,6 +11,9 @@ const NORMAL_FIELDS = [
     "type",
     "name",
     "ref",
+    "path",
+    "editable",
+    "editHint",
     "id",
     "description",
     "preview",
@@ -28,6 +31,9 @@ const AGENT_FIELDS = [
     "type",
     "name",
     "ref",
+    "path",
+    "editable",
+    "editHint",
     "id",
     "description",
     "supportRefs",
@@ -37,7 +43,10 @@ const AGENT_FIELDS = [
 ];
 function shapeCurateItem(item, detail, shape) {
     if (shape === "agent") {
-        return capDescription(pickFields(item, AGENT_FIELDS), NORMAL_DESCRIPTION_LIMIT);
+        const shaped = pickFields(item, AGENT_FIELDS);
+        if (shaped.editable !== false)
+            delete shaped.editHint;
+        return capDescription(shaped, NORMAL_DESCRIPTION_LIMIT);
     }
     if (detail === "brief") {
         return pickFields(item, BRIEF_FIELDS);

package/dist/output/shapes/events.js

@@ -1,12 +1,17 @@
 // 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/.
-// Output shape registration for `akm events list` and `akm events tail` (#204).
-// Both share the same envelope; the renderer in text.ts uses distinct command
-// names so it can format streaming differently.
+// Output shape registration for `akm log` (#204).
+//
+// R-060: renamed from `events-list` (the command group used to be `akm
+// events`) to `log-list`, matching the current `akm log` command name
+// (src/commands/observability-cli.ts). This string is an internal registry
+// key only — `shapeEventsOutput` builds its own envelope and never stamps a
+// `shape` field on the wire, so the rename does not require a schemaVersion
+// bump.
+//
+// 0.9.0 CLI overhaul (S3): `log tail` (and its `log-tail` shape entry) was
+// dropped along with the command.
 import { shapeEventsOutput } from "./helpers.js";
 const handler = (result, detail) => shapeEventsOutput(result, detail);
-export const eventsShapes = [
-    { command: "events-list", handler },
-    { command: "events-tail", handler },
-];
+export const eventsShapes = [{ command: "log-list", handler }];