akm-cli 0.9.0-rc.4 → 0.9.0-rc.6

package/dist/output/renderers.js

@@ -15,8 +15,7 @@ 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, workflowProgramRenderer } from "../workflows/renderer.js";
 // ── Interpreter auto-detection map ───────────────────────────────────────────
@@ -219,60 +218,40 @@ 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. Use 'toc' view for large documents.";
 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 type = "knowledge";
+        const name = deriveName(ctx);
+        const v = ctx.matchResult.meta?.view ?? { mode: "full" };
+        const content = ctx.content();
+        const action = KNOWLEDGE_ACTION;
+        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 = `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 };
+            }
+        }
     },
 };
 // ── 4c. lesson-md ────────────────────────────────────────────────────────────
@@ -508,228 +487,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 +494,6 @@ const builtinRenderers = [
     commandMdRenderer,
     agentMdRenderer,
     knowledgeMdRenderer,
-    wikiMdRenderer,
     lessonMdRenderer,
     memoryMdRenderer,
     workflowMdRenderer,
@@ -759,4 +515,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, workflowProgramRenderer, };
+export { agentMdRenderer, commandMdRenderer, envFileRenderer, factMdRenderer, INTERPRETER_MAP, knowledgeMdRenderer, lessonMdRenderer, memoryMdRenderer, SETUP_SIGNALS, scriptSourceRenderer, secretFileRenderer, skillMdRenderer, workflowMdRenderer, workflowProgramRenderer, };

package/dist/output/shapes/passthrough.js

@@ -22,6 +22,9 @@ const PASSTHROUGH_COMMANDS = [
     "add",
     "agent-result",
     "backup",
+    "bundle-items",
+    "bundle-list",
+    "bundle-show",
     "clone",
     "config",
     "disable",
@@ -79,15 +82,6 @@ const PASSTHROUGH_COMMANDS = [
     "tasks-sync",
     "update",
     "upgrade",
-    "wiki-create",
-    "wiki-ingest",
-    "wiki-lint",
-    "wiki-list",
-    "wiki-pages",
-    "wiki-register",
-    "wiki-remove",
-    "wiki-show",
-    "wiki-stash",
     "workflow-abandon",
     "workflow-brief",
     "workflow-complete",

package/dist/output/shapes/registry.js

@@ -1,7 +1,15 @@
 // 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/.
-const OUTPUT_SHAPE_REGISTRY = new Map();
+/**
+ * Output shape registry.
+ *
+ * Separated from `shapes.ts` so per-command shape modules can import
+ * `registerOutputShape` without creating a circular dependency back into
+ * the main shapes module.
+ */
+import { createCommandRegistry } from "../command-registry.js";
+const OUTPUT_SHAPE_REGISTRY = createCommandRegistry();
 /**
  * Register an output shape handler for a command name.
  *
@@ -13,7 +21,7 @@ const OUTPUT_SHAPE_REGISTRY = new Map();
  * ```
  */
 export function registerOutputShape(command, handler) {
-    OUTPUT_SHAPE_REGISTRY.set(command, handler);
+    OUTPUT_SHAPE_REGISTRY.register(command, handler);
 }
 /**
  * Register a batch of {@link OutputShapeEntry} definitions in iteration order.
@@ -23,15 +31,13 @@ export function registerOutputShape(command, handler) {
  * with no reliance on module import order.
  */
 export function registerOutputShapes(entries) {
-    for (const { command, handler } of entries) {
-        OUTPUT_SHAPE_REGISTRY.set(command, handler);
-    }
+    OUTPUT_SHAPE_REGISTRY.registerAll(entries);
 }
 /**
  * Remove a previously-registered output shape. Test-only utility.
  */
 export function deregisterOutputShape(command) {
-    OUTPUT_SHAPE_REGISTRY.delete(command);
+    OUTPUT_SHAPE_REGISTRY.deregister(command);
 }
 /**
  * Look up a registered output shape handler by command name.