akm-cli 0.7.4 → 0.8.0-rc1

package/dist/output/renderers.js

@@ -14,6 +14,7 @@ import { parseFrontmatter, toStringOrUndefined } from "../core/frontmatter";
 import { extractFrontmatterOnly, extractLineRange, extractSection, formatToc, parseMarkdownToc, } from "../core/markdown";
 import { registerRenderer } from "../indexer/file-context";
 import { extractCommentMetadata, extractDescriptionFromComments } from "../indexer/metadata";
+import { registerMetadataContributor } from "../indexer/metadata-contributors";
 import { buildWorkflowAction, workflowMdRenderer } from "../workflows/renderer";
 // ── Interpreter auto-detection map ───────────────────────────────────────────
 const INTERPRETER_MAP = {
@@ -278,16 +279,6 @@ const knowledgeMdRenderer = {
             }
         }
     },
-    extractMetadata(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
-        }
-    },
 };
 // ── 4b. wiki-md ──────────────────────────────────────────────────────────────
 const WIKI_PAGE_ACTION = "Wiki page — read below. Use 'toc' to scan, 'section <heading>' for depth.";
@@ -357,16 +348,6 @@ const wikiMdRenderer = {
             }
         }
     },
-    extractMetadata(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
-        }
-    },
 };
 // ── 4c. lesson-md ────────────────────────────────────────────────────────────
 /**
@@ -398,33 +379,6 @@ const lessonMdRenderer = {
             content: parsed.content,
         };
     },
-    extractMetadata(entry, ctx) {
-        try {
-            const parsed = parseFrontmatter(ctx.content());
-            const fm = parsed.data;
-            const desc = toStringOrUndefined(fm.description);
-            if (desc && !entry.description) {
-                entry.description = desc;
-                entry.source = "frontmatter";
-                entry.confidence = 0.9;
-            }
-            const whenToUse = toStringOrUndefined(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);
-            }
-            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]));
-                }
-            }
-        }
-        catch {
-            // Non-fatal: skip metadata extraction on parse error
-        }
-    },
 };
 // ── 5. memory-md ─────────────────────────────────────────────────────────────
 const memoryMdRenderer = {
@@ -439,58 +393,6 @@ const memoryMdRenderer = {
             content: ctx.content(),
         };
     },
-    extractMetadata(entry, ctx) {
-        try {
-            const parsed = parseFrontmatter(ctx.content());
-            const fm = parsed.data;
-            // Description from frontmatter
-            const desc = toStringOrUndefined(fm.description);
-            if (desc && !entry.description) {
-                entry.description = desc;
-                entry.source = "frontmatter";
-                entry.confidence = 0.9;
-            }
-            // Tags from frontmatter
-            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]));
-                }
-            }
-            // Build searchHints from structured memory metadata fields
-            const hints = new Set(entry.searchHints ?? []);
-            const source = toStringOrUndefined(fm.source);
-            if (source)
-                hints.add(source);
-            // observed_at: prefer frontmatter value, fall back to file mtime
-            const fmObservedAt = toStringOrUndefined(fm.observed_at);
-            if (fmObservedAt) {
-                hints.add(`observed_at:${fmObservedAt}`);
-            }
-            else {
-                // mtime fallback: format as ISO date (YYYY-MM-DD)
-                try {
-                    const mtime = ctx.stat().mtime;
-                    const isoDate = mtime.toISOString().slice(0, 10);
-                    hints.add(`observed_at:${isoDate}`);
-                }
-                catch {
-                    // Non-fatal: skip mtime fallback on stat error
-                }
-            }
-            const expires = toStringOrUndefined(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
-        }
-    },
 };
 // ── 6. workflow-md ───────────────────────────────────────────────────────────
 // Defined in src/workflows/renderer.ts and imported above.
@@ -537,16 +439,6 @@ const scriptSourceRenderer = {
                 throw error;
         }
     },
-    extractMetadata(entry, ctx) {
-        if (ctx.ext !== ".md") {
-            const commentDesc = extractDescriptionFromComments(ctx.absPath);
-            if (commentDesc && !entry.description) {
-                entry.description = commentDesc;
-                entry.source = "comments";
-                entry.confidence = 0.7;
-            }
-        }
-    },
 };
 // ── 8. vault-env ─────────────────────────────────────────────────────────────
 /**
@@ -563,28 +455,207 @@ const vaultEnvRenderer = {
             type: "vault",
             name,
             path: ctx.absPath,
-            action: 'Vault — keys + comments only. Use `eval "$(akm vault load <ref>)"` to load values into the current shell. Values stay on disk and are never written to akm\'s stdout.',
+            action: 'Vault — keys + comments only. Use `source "$(akm vault path <ref>)"` to load values into the current shell, or `akm vault run <ref[/KEY]> -- <command>` to run with injected env. Values stay on disk and are never written to akm\'s stdout.',
             description: comments.length > 0 ? comments.join("\n") : undefined,
             keys,
             comments,
         };
     },
-    extractMetadata(entry, ctx) {
-        // Re-derive from the file directly to guarantee no value ever transits
-        // through any other code path. Caller already short-circuits in
-        // generateMetadata{,Flat}, but this is defense in depth.
-        const { keys, comments } = listVaultKeys(ctx.absPath);
-        if (comments.length > 0 && !entry.description) {
-            entry.description = comments.join(" ").slice(0, 500);
-            entry.source = "comments";
-            entry.confidence = 0.7;
-        }
-        if (keys.length > 0) {
-            entry.searchHints = keys;
-        }
-        entry.tags = Array.from(new Set([...(entry.tags ?? []), "vault", "secrets"]));
+    enrichSearchHit(hit, _stashDir) {
+        const { keys } = listVaultKeys(hit.path);
+        if (keys.length > 0)
+            hit.keys = keys;
+    },
+};
+// ── 7. task-md ───────────────────────────────────────────────────────────────
+const TASK_PAGE_ACTION = "Scheduled task — `akm tasks show <id>` for parsed details, `akm tasks run <id>` to invoke now.";
+const taskMdRenderer = {
+    name: "task-md",
+    buildShowResponse(ctx) {
+        const name = deriveName(ctx);
+        return {
+            type: "task",
+            name,
+            path: ctx.absPath,
+            action: TASK_PAGE_ACTION,
+            content: ctx.content(),
+        };
     },
 };
+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
+    }
+}
+function applyLessonMetadata(entry, ctx) {
+    try {
+        const parsed = parseFrontmatter(ctx.content());
+        const fm = parsed.data;
+        const desc = toStringOrUndefined(fm.description);
+        if (desc && !entry.description) {
+            entry.description = desc;
+            entry.source = "frontmatter";
+            entry.confidence = 0.9;
+        }
+        const whenToUse = toStringOrUndefined(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);
+        }
+        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]));
+            }
+        }
+    }
+    catch {
+        // Non-fatal: skip metadata extraction on parse error
+    }
+}
+function applyMemoryMetadata(entry, ctx) {
+    try {
+        const parsed = parseFrontmatter(ctx.content());
+        const fm = parsed.data;
+        const desc = toStringOrUndefined(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]));
+            }
+        }
+        const hints = new Set(entry.searchHints ?? []);
+        const source = toStringOrUndefined(fm.source);
+        if (source)
+            hints.add(source);
+        const fmObservedAt = toStringOrUndefined(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 = toStringOrUndefined(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 applyVaultMetadata(entry, ctx) {
+    const { keys, comments } = listVaultKeys(ctx.absPath);
+    if (comments.length > 0 && !entry.description) {
+        entry.description = comments.join(" ").slice(0, 500);
+        entry.source = "comments";
+        entry.confidence = 0.7;
+    }
+    if (keys.length > 0) {
+        entry.searchHints = keys;
+    }
+    entry.tags = Array.from(new Set([...(entry.tags ?? []), "vault", "secrets"]));
+}
+function applyTaskMetadata(entry, ctx) {
+    try {
+        const parsed = parseFrontmatter(ctx.content());
+        const fm = parsed.data;
+        const desc = toStringOrUndefined(fm.description);
+        if (desc && !entry.description) {
+            entry.description = desc;
+            entry.source = "frontmatter";
+            entry.confidence = 0.9;
+        }
+        if (Array.isArray(fm.tags)) {
+            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]));
+            }
+        }
+        entry.tags = Array.from(new Set([...(entry.tags ?? []), "task", "scheduled"]));
+        const hints = new Set(entry.searchHints ?? []);
+        const schedule = toStringOrUndefined(fm.schedule);
+        if (schedule)
+            hints.add(`schedule:${schedule}`);
+        const workflow = toStringOrUndefined(fm.workflow);
+        if (workflow)
+            hints.add(`workflow:${workflow}`);
+        const prompt = toStringOrUndefined(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: "knowledge-toc-metadata",
+    appliesTo: ({ rendererName }) => rendererName === "knowledge-md",
+    contribute: (entry, ctx) => applyTocMetadata(entry, ctx.renderContext),
+});
+registerMetadataContributor({
+    name: "wiki-toc-metadata",
+    appliesTo: ({ rendererName }) => 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: "vault-secret-metadata",
+    appliesTo: ({ rendererName }) => rendererName === "vault-env",
+    contribute: (entry, ctx) => applyVaultMetadata(entry, ctx.renderContext),
+});
+registerMetadataContributor({
+    name: "task-frontmatter-metadata",
+    appliesTo: ({ rendererName }) => rendererName === "task-md",
+    contribute: (entry, ctx) => applyTaskMetadata(entry, ctx.renderContext),
+});
 // ── Registration ─────────────────────────────────────────────────────────────
 /** All built-in renderers. */
 const builtinRenderers = [
@@ -598,6 +669,7 @@ const builtinRenderers = [
     workflowMdRenderer,
     scriptSourceRenderer,
     vaultEnvRenderer,
+    taskMdRenderer,
 ];
 /**
  * Register all built-in renderers with the file-context registry.

package/dist/output/shapes.js

@@ -45,12 +45,20 @@ export function shapeForCommand(command, result, detail, forAgent = false) {
         case "reflect":
         case "propose":
             return shapeProposalProducerOutput(result, detail);
+        case "improve":
+            return result;
         // Output shape registration for `akm distill <ref>` (#228). The shape is
         // simple — outcome + ids + optional payload — so `brief` strips the full
         // proposal blob, `normal` keeps the headline fields, and `full` projects
         // everything for downstream automation.
         case "distill":
             return shapeDistillOutput(result, detail);
+        case "graph-summary":
+        case "graph-entities":
+        case "graph-relations":
+        case "graph-related":
+        case "graph-export":
+            return result;
         // Identity-passthrough commands — registered here so the registry stays
         // exhaustive (v1 spec §9). Each result object is already shaped at the
         // command boundary; the registry just confirms there's no surprise
@@ -64,6 +72,7 @@ export function shapeForCommand(command, result, detail, forAgent = false) {
         case "feedback":
         case "import":
         case "index":
+        case "health":
         case "info":
         case "init":
         case "list":
@@ -97,6 +106,27 @@ export function shapeForCommand(command, result, detail, forAgent = false) {
         case "workflow-start":
         case "workflow-status":
         case "workflow-validate":
+        case "tasks-add":
+        case "tasks-list":
+        case "tasks-show":
+        case "tasks-remove":
+        case "tasks-enable":
+        case "tasks-disable":
+        case "tasks-run":
+        case "tasks-history":
+        case "tasks-sync":
+        case "tasks-doctor":
+            return result;
+        // Output shape registration for `akm lint`, `akm setup`, and `akm consolidate`.
+        // Each result is already fully shaped at the command boundary; pass through as-is.
+        case "lint":
+        case "setup":
+        case "consolidate":
+            return result;
+        // Output shape registration for `akm agent <profile>`. The result carries
+        // structured agent-run fields; the text renderer uses the interactive/
+        // captured distinction to decide what to print.
+        case "agent-result":
             return result;
         default:
             // v1 spec §9 (output-shape registry exhaustive): no silent JSON.stringify
@@ -407,19 +437,22 @@ export function shapeSearchHit(hit, detail) {
     // `ref` is included at `brief` so agents can run `akm show <ref>` without
     // needing --detail full or --for-agent (REC-03).
     if (detail === "brief")
-        return pickFields(hit, ["type", "name", "ref", "action", "estimatedTokens"]);
+        return pickFields(hit, ["type", "name", "ref", "action", "estimatedTokens", "keys"]);
     if (detail === "normal") {
         // `warnings` is projected at `normal` so non-fatal hit-level issues are
         // visible without forcing callers up to `--detail full`. Optional
         // `quality` (v1 spec §4.2) is also surfaced when present so callers
         // can see why a `proposed` entry showed up under `--include-proposed`.
-        return capDescription(pickFields(hit, ["type", "name", "description", "action", "score", "estimatedTokens", "warnings", "quality"]), NORMAL_DESCRIPTION_LIMIT);
+        const shaped = capDescription(pickFields(hit, ["type", "name", "description", "action", "score", "estimatedTokens", "warnings", "quality"]), NORMAL_DESCRIPTION_LIMIT);
+        if (Array.isArray(hit.keys) && hit.keys.length > 0)
+            shaped.keys = hit.keys;
+        return shaped;
     }
     return hit;
 }
 /** Agent-optimized search hit: only fields an LLM agent needs to decide and act */
 export function shapeSearchHitForAgent(hit) {
-    const picked = pickFields(hit, ["name", "ref", "type", "description", "action", "score", "estimatedTokens"]);
+    const picked = pickFields(hit, ["name", "ref", "type", "description", "action", "score", "estimatedTokens", "keys"]);
     return capDescription(picked, NORMAL_DESCRIPTION_LIMIT);
 }
 export function capDescription(hit, limit) {
@@ -449,6 +482,7 @@ export function shapeShowOutput(result, detail, forAgent = false) {
             "run",
             "setup",
             "cwd",
+            "activeRun",
             "toolPolicy",
             "modelHint",
             "agent",
@@ -458,6 +492,7 @@ export function shapeShowOutput(result, detail, forAgent = false) {
             "steps",
             "keys",
             "comments",
+            "related",
         ]);
     }
     if (detail === "summary") {
@@ -473,6 +508,7 @@ export function shapeShowOutput(result, detail, forAgent = false) {
             "origin",
             "keys",
             "comments",
+            "related",
         ]);
     }
     const base = pickFields(result, [
@@ -495,8 +531,10 @@ export function shapeShowOutput(result, detail, forAgent = false) {
         "run",
         "setup",
         "cwd",
+        "activeRun",
         "keys",
         "comments",
+        "related",
         // path and editable are always projected so JSON consumers can locate and
         // edit the asset without needing --detail full (QA #7).
         "path",