akm-cli 0.9.7 → 0.9.8-beta.2

package/dist/commands/workflow-cli.js

@@ -7,18 +7,12 @@
  * `create --print` emits Markdown; execution accepts peer `.md` and
  * GitHub-shaped `.yml` workflow sources. Validate with `akm lint --type workflows`.
  */
-import { getParsedInvocation } from "../cli/invocation.js";
 import { getStringArg } from "../cli/parse-args.js";
 import { defineGroupCommand, defineJsonCommand, EXIT_CODES, output } from "../cli/shared.js";
 import { armAbortDeadline } from "../core/abort-deadline.js";
 import { assertFlatAssetName, combineCreatePath, normalizeCreateSubPath } from "../core/asset/asset-create.js";
 import { NotFoundError, UsageError } from "../core/errors.js";
 import { akmIndex } from "../indexer/indexer.js";
-import { getOutputMode } from "../output/context.js";
-import { renderGenericText } from "../output/generic-render.js";
-import { deliverRendered } from "../output/html-render.js";
-import { shapeForCommand } from "../output/shapes.js";
-import { formatPlain } from "../output/text.js";
 import { assertWorkflowMarkdownName, createWorkflowAsset, getWorkflowTemplate } from "../workflows/authoring/authoring.js";
 import { WORKFLOW_MAX_TIMEOUT_MS } from "../workflows/ir/schema.js";
 import { abandonWorkflowRun, getWorkflowStatus, hasWorkflowRun, listWorkflowRuns, resumeWorkflowRun, } from "../workflows/runtime/runs.js";
@@ -319,61 +313,17 @@ const workflowPlanCommand = defineJsonCommand({
     },
     async run({ args }) {
         const result = await akmWorkflowPlan(args.ref);
-        // B-46/B-57: `akm workflow plan` is read-only introspection whose UNMARKED
-        // default is a human summary — `--format json` (B-N9) is the opt-in for
-        // the full structure, the mirror image of every other verb's json-by-
-        // default (DEFAULT_CONFIG.output.format).
-        //
-        // Detecting "the caller named no format at all" MUST NOT read
-        // `args.format` (code-review round 4, finding 3 / Review log R3):
-        // citty's one-parse rule (GLOBAL_OUTPUT_ARGS's own doc comment, "no
-        // command body may read these args") isn't just style here — reading it
-        // is actively wrong. citty parses each command level against only that
-        // level's own remaining argv, so a GLOBAL, pre-subcommand `--format json`
-        // (e.g. `akm --format json workflow plan <ref>`) is consumed by the ROOT
-        // command's own declared `format` arg before the `workflow`/`plan`
-        // subcommand tokens are even resolved — this LEAF's `args.format` reads
-        // `undefined` in exactly that case too, indistinguishable from "no
-        // format was named anywhere". Reproduced live: that invocation printed
-        // the human TEXT summary at exit 0 even though `getOutputMode().format`
-        // was already `"json"` (the control, `akm --format json workflow list`,
-        // correctly emitted JSON — only this leaf's own arg-read was wrong).
-        // Detect it instead off the process-wide invocation singleton
-        // (`getParsedInvocation`, src/cli/invocation.ts) — the same canonical,
-        // position-independent argv parse `src/cli.ts` mints ONCE at startup
-        // (`setParsedInvocation`, immediately before `initOutputMode` builds the
-        // `getOutputMode()` singleton from that identical argv), so this agrees
-        // with `getOutputMode()` regardless of where `--format` appeared. A bare
-        // `process.argv` read is reserved for `src/cli.ts`/`cli/invocation.ts`
-        // themselves (`lint-process-argv.ts`); every other module reads through
-        // this singleton instead. When explicit, this defers to the normal
-        // `output()` path (json/yaml/text/md/html/jsonl, `--output <path>`)
-        // unchanged; when absent, it reproduces `output()`'s OWN "text" branch
-        // verbatim (same shape/detail projection, same registered-formatter-or-
-        // generic-fallback, same `--output <path>` handling) without touching
-        // the shared dispatcher other commands rely on.
-        //
-        // "No format named anywhere" also has to check the RESOLVED mode, not
-        // just argv: `getOutputMode().format` already folds a persisted
-        // `output.format` config default in ahead of the hardcoded "json"
-        // fallback (`resolveOutputMode`, src/output/context.ts — argv ?? config
-        // default ?? "json"). A user who has configured e.g. `output.format:
-        // "yaml"` gets yaml from every other command with no `--format` on the
-        // line; `workflow plan` must honor that too instead of forcing its
-        // human-text branch over a real persisted default. A resolved format of
-        // exactly "json" is deliberately left on the text branch below: it's
-        // indistinguishable from "nothing configured" (DEFAULT_CONFIG.output.format
-        // is also "json" — OutputConfigSchema's `format` carries no independent
-        // zod default, so the merge is the only source), and collapsing that case
-        // onto the JSON envelope would erase the documented unmarked-default text
-        // summary for the overwhelmingly common "user configured nothing" case.
-        const mode = getOutputMode();
-        if (getParsedInvocation().getFlagValue("--format") === undefined && mode.format === "json") {
-            const shaped = shapeForCommand("workflow-plan", result, mode.detail, mode.shape);
-            const plain = formatPlain("workflow-plan", shaped, mode.detail);
-            deliverRendered(plain ?? renderGenericText("workflow-plan", shaped), mode.outputPath);
-            return;
-        }
+        // json-by-default, like every other verb (#903). This used to default to
+        // the human summary, which cost ~60 lines of branch: `args.format` cannot
+        // detect "no format named" (citty parses per level, so a global
+        // pre-subcommand `--format json` is eaten by the ROOT command and the leaf
+        // reads undefined), so it had to route through `getParsedInvocation()`,
+        // then fold in a persisted `output.format`, and then still leave a
+        // resolved "json" on the text branch because that is indistinguishable
+        // from "nothing configured". The last compromise meant an explicit
+        // `--format json` silently did nothing for anyone whose config already
+        // resolved to json. `--format text` still renders the summary through the
+        // registered formatter; it is just no longer the unmarked default.
         output("workflow-plan", result);
     },
 });

package/dist/core/adapter/adapters/agent-skills-adapter.js

@@ -44,6 +44,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import { parseFrontmatter } from "../../asset/frontmatter.js";
+import { toPosix } from "../../common.js";
 import { hashContent, nonEmptyString, readTags } from "./shared.js";
 /** A skills collection is a single-component bundle; its one component is `main`. */
 const COMPONENT_ID = "main";
@@ -56,11 +57,6 @@ const DESCRIPTION_MAX = 1024;
 const RESERVED_NAME_WORDS = ["anthropic", "claude"];
 /** name charset/shape rule (spec §4.5). */
 const NAME_RE = /^[a-z0-9]+(-[a-z0-9]+)*$/;
-/** Upper bound on the bounded `content` FTS field (mirrors okf-adapter). */
-const MAX_CONTENT_CHARS = 100_000;
-function toPosix(p) {
-    return p.replace(/\\/g, "/");
-}
 /** conceptId + package-dir name for a `<name>/SKILL.md` file, or null when the file is not a skill manifest. */
 function skillPackage(relPath) {
     const posix = toPosix(relPath);
@@ -95,7 +91,7 @@ function recognize(c, file) {
         adapterId: "agent-skills",
         type: "skill",
         name,
-        content: body.length > MAX_CONTENT_CHARS ? body.slice(0, MAX_CONTENT_CHARS) : body,
+        content: body,
     };
     if (description !== undefined)
         doc.description = description;

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

@@ -88,7 +88,7 @@ import { executionDefaultsFromFrontmatter, renderMarkdownExecutionSource } from
 import { recognizeMatch } from "../recognize-match.js";
 import { perTypeValidateChecks, skillDirectoryDiagnostics, workflowYamlSourceDiagnostics } from "./akm-lint.js";
 import { applyFoldedMetadata, foldRecognizedMetadata } from "./akm-metadata.js";
-import { hashContent, runBaseValidateChecks } from "./shared.js";
+import { hashContent, RESERVED_FILES, runBaseValidateChecks } from "./shared.js";
 // `recognizeMatch` + the builtin matcher list moved to the cycle-free leaf
 // `../recognize-match` (Chunk 5 M-b) so both this adapter AND the indexer
 // metadata pass import it without closing a metadata ↔ adapter cycle. Re-exported
@@ -99,12 +99,11 @@ export { recognizeMatch } from "../recognize-match.js";
  * OKF reserved structural files (ref-grammar decision D-R6, spec §5.1 /
  * adapter-spec §5.1/§6): `index.md` (directory listing) and `log.md` (update
  * history) are bundle structure at EVERY depth — never a concept document. The
- * `okf` / `llm-wiki` adapters already exclude them (`okf-adapter.ts`
+ * `okf` / `llm-wiki` adapters already exclude them (`shared.ts`'s
  * `RESERVED_FILES`); this brings the `akm` adapter into conformance so a
  * `knowledge/index.md` never classifies as a `knowledge` item. Case-insensitive,
  * matched on the bare filename so the exclusion holds at any depth.
  */
-const RESERVED_FILES = new Set(["index.md", "log.md"]);
 /** True when `name` (a bare file name) is an OKF reserved file, case-insensitively (D-R6). */
 function isReservedFileName(name) {
     return RESERVED_FILES.has(name.toLowerCase());

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

@@ -57,7 +57,7 @@ import { taskSourceErrorDetail } from "../../../tasks/source-v3.js";
 import { compileWorkflowPlan } from "../../../workflows/ir/compile.js";
 import { compileWorkflowSource } from "../../../workflows/source-ir/compile.js";
 import { conceptIdForStashFile } from "../../asset/resolve-ref.js";
-import { isAkmRegistryCachePath } from "../../common.js";
+import { isAkmRegistryCachePath, scanEnvKeyNames } from "../../common.js";
 /** Recommended `category` values for facts — `commands/lint/fact-linter.ts:9`. */
 const KNOWN_CATEGORIES = new Set(["personal", "team", "project", "convention", "meta"]);
 /** Placeholder markers a workflow stub carries — `commands/lint/workflow-linter.ts:10`. */
@@ -118,24 +118,6 @@ export function nameOrTypeDiagnostics(relPath, data, frontmatter, allowedTypes)
     return [];
 }
 // ── env dangerous-key scan (content-based port of env-key-rules.ts) ──────────
-/** Matches a KEY=value assignment line, capturing only the key — `commands/env/env.ts:62`. */
-const ASSIGN_RE = /^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=/;
-/** Port of `commands/env/env.ts#scanKeys` (`:65-77`) — content-based (overlay `raw`, not disk). */
-function scanKeys(text) {
-    const keys = [];
-    const seen = new Set();
-    for (const line of text.split(/\r?\n/)) {
-        const m = line.match(ASSIGN_RE);
-        if (!m)
-            continue;
-        const key = m[1];
-        if (seen.has(key))
-            continue;
-        seen.add(key);
-        keys.push(key);
-    }
-    return keys;
-}
 /** Port of `env-key-rules.ts#collectSuppressedKeys` (`:144-164`) — content-based. */
 function collectSuppressedKeys(raw) {
     const suppressed = new Set();
@@ -171,7 +153,7 @@ export function dangerousEnvKeyDiagnostics(type, relPath, raw) {
         return []; // NARROWNESS: collectEnvFiles only visits *.env
     // `relPath` is already stash-root-relative, so "." IS the stash root here.
     const ref = conceptIdForStashFile(type, ".", relPath);
-    const keys = scanKeys(raw);
+    const keys = scanEnvKeyNames(raw);
     const suppressed = collectSuppressedKeys(raw);
     const diagnostics = [];
     for (const key of keys) {

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

@@ -35,16 +35,12 @@ import fs from "node:fs";
 import path from "node:path";
 import { parseTaskSource } 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";
 /** A native task bundle is single-component; its one component is `main`. */
 const COMPONENT_ID = "main";
 /** The task YAML extension (spec §6 task row). */
 const TASK_EXT = TASK_EXTENSION;
-/** Upper bound on the bounded `content` FTS field (mirrors okf-adapter). */
-const MAX_CONTENT_CHARS = 100_000;
-function toPosix(p) {
-    return p.replace(/\\/g, "/");
-}
 function recognize(c, file) {
     if (file.ext !== TASK_EXT)
         return null;
@@ -61,7 +57,7 @@ function recognize(c, file) {
         adapterId: "akm-task",
         type: "task",
         name,
-        content: raw.length > MAX_CONTENT_CHARS ? raw.slice(0, MAX_CONTENT_CHARS) : raw,
+        content: raw,
     };
 }
 async function validate(c, changes, ctx) {

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

@@ -23,17 +23,13 @@ import fs from "node:fs";
 import path from "node:path";
 import { looksLikeGithubWorkflowSource } from "../../../workflows/source-ir/compile.js";
 import { parseFrontmatter } from "../../asset/frontmatter.js";
+import { toPosix } from "../../common.js";
 import { perTypeValidateChecks, workflowYamlSourceDiagnostics } from "./akm-lint.js";
 import { hashContent, nonEmptyString, readTags, runBaseValidateChecks } from "./shared.js";
 /** A native workflow bundle is single-component; its one component is `main`. */
 const COMPONENT_ID = "main";
 /** The two authoritative workflow source formats. `.yaml` is deliberately not accepted. */
 const WORKFLOW_EXTS = new Set([".md", ".yml"]);
-/** Upper bound on the bounded `content` FTS field (mirrors okf-adapter). */
-const MAX_CONTENT_CHARS = 100_000;
-function toPosix(p) {
-    return p.replace(/\\/g, "/");
-}
 /** Strip the recognized workflow extension from a component-root-relative path → conceptId. */
 function conceptIdOf(relPath) {
     return toPosix(relPath).replace(/\.(?:md|yml)$/i, "");
@@ -78,7 +74,7 @@ function recognize(c, file) {
         adapterId: "akm-workflow",
         type: "workflow",
         name,
-        content: body.length > MAX_CONTENT_CHARS ? body.slice(0, MAX_CONTENT_CHARS) : body,
+        content: body,
     };
     if (description !== undefined)
         doc.description = description;

package/dist/core/adapter/adapters/dotenv-adapter.js

@@ -30,6 +30,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import { assetPathCandidatesForName, assetPathForName, typeForStashDir } from "../../asset/asset-placement.js";
+import { scanEnvKeyNames, toPosix } from "../../common.js";
 import { dangerousEnvKeyDiagnostics } from "./akm-lint.js";
 import { hashContent } from "./shared.js";
 /** A dotenv bundle is single-component; its one component is `main`. */
@@ -40,11 +41,6 @@ const ENV_DIR = "env";
 const SECRETS_DIR = "secrets";
 /** Non-secret marker suffixes under `secrets/` (spec §6 secret row). */
 const SECRET_SKIP_SUFFIXES = [".lock", ".sensitive"];
-/** Matches a KEY=value assignment line, capturing only the key (mirrors akm-lint scanKeys). */
-const ASSIGN_RE = /^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=/;
-function toPosix(p) {
-    return p.replace(/\\/g, "/");
-}
 /** Classify a component-root-relative file as env / secret, or null (abstain). */
 function classify(relPath) {
     const posix = toPosix(relPath);
@@ -80,22 +76,6 @@ function hasSensitiveMarker(absPath, type) {
     const marker = type === "env" ? absPath.replace(/\.env$/i, ".sensitive") : `${absPath}.sensitive`;
     return marker !== absPath && fs.existsSync(marker);
 }
-/** Extract KEY NAMES (never values) from an env file's raw content, first-appearance order, deduped. */
-function scanKeyNames(raw) {
-    const keys = [];
-    const seen = new Set();
-    for (const line of raw.split(/\r?\n/)) {
-        const m = line.match(ASSIGN_RE);
-        if (!m)
-            continue;
-        const key = m[1];
-        if (seen.has(key))
-            continue;
-        seen.add(key);
-        keys.push(key);
-    }
-    return keys;
-}
 function conceptIdForPath(type, relativePath) {
     const posix = toPosix(relativePath);
     if (type === "secret")
@@ -115,7 +95,7 @@ function recognize(c, file) {
         // env: strip `.env`; surface KEY NAMES only (never values/comments/content).
         const conceptId = conceptIdForPath(type, posix);
         const name = (conceptId.split("/").pop() ?? conceptId) || "default";
-        const keys = scanKeyNames(raw);
+        const keys = scanEnvKeyNames(raw);
         const doc = {
             ref: `${c.id}//${conceptId}`,
             bundle: c.id,

package/dist/core/adapter/adapters/generic-files-adapter.js

@@ -23,19 +23,13 @@
  */
 import path from "node:path";
 import { parseFrontmatter } from "../../asset/frontmatter.js";
+import { toPosix } from "../../common.js";
 import { SCRIPT_EXTENSIONS } from "../../recognition-util.js";
-import { hashContent, nonEmptyString, readTags, runBaseValidateChecks } from "./shared.js";
+import { hashContent, nonEmptyString, RESERVED_FILES, readTags, runBaseValidateChecks } from "./shared.js";
 /** A generic-files bundle is single-component; its one component is `main`. */
 const COMPONENT_ID = "main";
 /** Markdown / plain-text extensions classified as `document`. */
 const DOCUMENT_EXTENSIONS = new Set([".md", ".markdown", ".txt", ".text"]);
-/** OKF reserved structural files (D-R6) — excluded from the catch-all, case-insensitive. */
-const RESERVED_FILES = new Set(["index.md", "log.md"]);
-/** Upper bound on the bounded `content` FTS field (mirrors okf-adapter). */
-const MAX_CONTENT_CHARS = 100_000;
-function toPosix(p) {
-    return p.replace(/\\/g, "/");
-}
 function isReserved(base) {
     return RESERVED_FILES.has(base.toLowerCase());
 }
@@ -69,7 +63,7 @@ function recognize(c, file) {
         adapterId: "generic-files",
         type,
         name,
-        content: body.length > MAX_CONTENT_CHARS ? body.slice(0, MAX_CONTENT_CHARS) : body,
+        content: body,
     };
     if (type !== "script")
         doc.ownsPresentation = true;

package/dist/core/adapter/adapters/llm-wiki-adapter.js

@@ -73,6 +73,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { parse as parseYaml } from "yaml";
 import { parseFrontmatter, parseFrontmatterBlock } from "../../asset/frontmatter.js";
+import { toPosix } from "../../common.js";
 import { hashContent, nonEmptyString } from "./shared.js";
 /** A wiki is a single-component bundle; its one component is conventionally `main` (recognition golden). */
 const WIKI_COMPONENT_ID = "main";
@@ -86,12 +87,7 @@ const RESERVED_ROOT_FILES = new Set(["schema.md", "index.md", "log.md"]);
 const RAW_SUBDIR = "raw";
 /** Content subdirectory holding agent-authored pages. */
 const PAGES_SUBDIR = "pages";
-/** Upper bound on the bounded `content` FTS field (mirrors okf-adapter). */
-const MAX_CONTENT_CHARS = 100_000;
 /** POSIX-normalize separators. */
-function toPosix(p) {
-    return p.replace(/\\/g, "/");
-}
 /** conceptId = component-root-relative path minus `.md`. */
 function conceptIdOf(relPath) {
     return toPosix(relPath).replace(/\.md$/i, "");
@@ -280,7 +276,7 @@ function recognize(c, file) {
         ownsPresentation: true,
         type: isRaw ? WIKI_SOURCE_TYPE : (fm.pageKind ?? DEFAULT_PAGE_KIND),
         name: lastSegment,
-        content: body.length > MAX_CONTENT_CHARS ? body.slice(0, MAX_CONTENT_CHARS) : body,
+        content: body,
     };
     if (fm.description !== undefined)
         doc.description = fm.description;

package/dist/core/adapter/adapters/okf-adapter.js

@@ -31,7 +31,8 @@
 import fs from "node:fs";
 import path from "node:path";
 import { parseFrontmatter } from "../../asset/frontmatter.js";
-import { hashContent, nonEmptyString, readTags, runBaseValidateChecks } from "./shared.js";
+import { isRecord, toPosix } from "../../common.js";
+import { hashContent, nonEmptyString, RESERVED_FILES, readTags, runBaseValidateChecks } from "./shared.js";
 /** v0.2 frontmatter keys consumed into first-class fields below (§0.1) — excluded from the generic `documentJson` extras fold alongside the v0.1 five, so nothing is duplicated between a first-class field and the opaque extras bag. */
 const CONSUMED_FRONTMATTER_KEYS = [
     "type",
@@ -46,17 +47,13 @@ const CONSUMED_FRONTMATTER_KEYS = [
     "stale_after",
     "okf_version",
 ];
-/** True for a plain (non-null, non-array) object — the shape every v0.2 mapping (`generated`, one `verified`/`sources` entry) must have. */
-function isPlainObject(value) {
-    return value !== null && typeof value === "object" && !Array.isArray(value);
-}
 /**
  * Parse one `verified:` actor mapping (`{by, at?}`). Tolerant: a missing/blank
  * `by` yields `undefined` (the entry is dropped, never rejecting the document
  * — OKF conformance leniency); `at` is independently optional.
  */
 function parseActorMapping(value) {
-    if (!isPlainObject(value))
+    if (!isRecord(value))
         return undefined;
     const by = nonEmptyString(value.by);
     if (by === undefined)
@@ -96,7 +93,7 @@ function parseOkfSources(value) {
         return undefined;
     const out = [];
     for (const item of value) {
-        if (!isPlainObject(item))
+        if (!isRecord(item))
             continue;
         const resource = nonEmptyString(item.resource);
         if (resource === undefined)
@@ -125,15 +122,7 @@ function parseOkfSources(value) {
 function parseLifecycleStatus(value) {
     return value === "draft" || value === "stable" || value === "deprecated" ? value : undefined;
 }
-/** Reserved OKF files (case-insensitive) — recognized, never indexed as concepts (§5, OKF §1.4). */
-const RESERVED_FILES = new Set(["index.md", "log.md"]);
-/** Upper bound on the bounded `content` FTS field (§3: "content: FTS 1 (bounded)"). Small fixtures are never truncated. */
-const MAX_CONTENT_CHARS = 100_000;
-/** POSIX-normalize separators without importing a cycle-participant helper. */
-function toPosix(p) {
-    return p.replace(/\\/g, "/");
-}
-/** True when `name` (a bare file name) is a reserved OKF file, case-insensitively. */
+/** True when `name` (a bare file name) is a reserved OKF file, case-insensitively (§5, OKF §1.4). */
 function isReservedFileName(name) {
     return RESERVED_FILES.has(name.toLowerCase());
 }
@@ -237,7 +226,7 @@ function recognize(c, file) {
     // `generated.at` — v0.2's replacement for `timestamp` — takes precedence;
     // `timestamp` remains a fully valid fallback (the v0.2-permitted legacy
     // reading, not merely tolerated). Both stay fully optional (never rejects).
-    const generatedMapping = isPlainObject(data.generated) ? data.generated : undefined;
+    const generatedMapping = isRecord(data.generated) ? data.generated : undefined;
     const generatedAt = generatedMapping ? nonEmptyString(generatedMapping.at) : undefined;
     const generatedBy = generatedMapping ? nonEmptyString(generatedMapping.by) : undefined;
     const legacyTimestamp = nonEmptyString(data.timestamp);
@@ -272,7 +261,7 @@ function recognize(c, file) {
         ownsPresentation: true,
         type,
         name,
-        content: body.length > MAX_CONTENT_CHARS ? body.slice(0, MAX_CONTENT_CHARS) : body,
+        content: body,
     };
     if (description !== undefined)
         doc.description = description;

package/dist/core/adapter/adapters/shared.js

@@ -69,6 +69,8 @@ export function readTags(value) {
     const tags = value.filter((tag) => typeof tag === "string" && tag.trim().length > 0);
     return tags.length > 0 ? tags : undefined;
 }
+/** Reserved files (case-insensitive) every concrete adapter recognizes but never indexes as a concept. */
+export const RESERVED_FILES = new Set(["index.md", "log.md"]);
 // ── Base validate checks (port of `BaseLinter.runBaseChecks`) ────────────────
 function checkMissingUpdated(data, frontmatterText) {
     return frontmatterText !== null && !("updated" in data);

package/dist/core/adapter/adapters/tool-dir-shared.js

@@ -49,21 +49,15 @@
 import path from "node:path";
 import { createAdapterExtensions, } from "../../../execution/source.js";
 import { parseFrontmatter } from "../../asset/frontmatter.js";
+import { toPosix } from "../../common.js";
 import { executionDefaultsFromFrontmatter, renderMarkdownExecutionSource } from "../execution-source.js";
 import { skillDirectoryDiagnostics } from "./akm-lint.js";
-import { hashContent, nonEmptyString, readTags, runBaseValidateChecks } from "./shared.js";
-/** OKF reserved structural files (D-R6) — excluded at every depth, case-insensitive. */
-const RESERVED_FILES = new Set(["index.md", "log.md"]);
-/** Upper bound on the bounded `content` FTS field (mirrors okf-adapter). */
-const MAX_CONTENT_CHARS = 100_000;
+import { hashContent, nonEmptyString, RESERVED_FILES, readTags, runBaseValidateChecks } from "./shared.js";
 /** The canonical (plural) subdir spellings writes normalize to (open-question-6). */
 const CANONICAL_COMMAND_DIR = "commands";
 const CANONICAL_AGENT_DIR = "agents";
 const CANONICAL_SKILL_DIR = "skills";
 const SKILL_MANIFEST = "SKILL.md";
-function toPosix(p) {
-    return p.replace(/\\/g, "/");
-}
 function isReserved(base) {
     return RESERVED_FILES.has(base.toLowerCase());
 }
@@ -122,7 +116,7 @@ export function recognizeToolDir(layout, c, file) {
         adapterId: layout.adapterId,
         type: cls.type,
         name,
-        content: body.length > MAX_CONTENT_CHARS ? body.slice(0, MAX_CONTENT_CHARS) : body,
+        content: body,
     };
     if (cls.type === "instruction")
         doc.ownsPresentation = true;

package/dist/core/adapter/adapters/website-snapshot-adapter.js

@@ -28,6 +28,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { parse as parseYaml } from "yaml";
 import { parseFrontmatter, parseFrontmatterBlock } from "../../asset/frontmatter.js";
+import { toPosix } from "../../common.js";
 import { hashContent, nonEmptyString, runBaseValidateChecks } from "./shared.js";
 /** A snapshot bundle is single-component; its one component is `main`. */
 const COMPONENT_ID = "main";
@@ -37,11 +38,6 @@ const PAGES_PREFIX = "stash/knowledge/";
 const MANIFEST_FILE = "manifest.json";
 /** The tag the snapshot writer stamps on every crawled page. */
 const WEBSITE_TAG = "website";
-/** Upper bound on the bounded `content` FTS field (mirrors okf-adapter). */
-const MAX_CONTENT_CHARS = 100_000;
-function toPosix(p) {
-    return p.replace(/\\/g, "/");
-}
 function parseSnapshotFrontmatter(raw) {
     const out = { tags: [] };
     const block = parseFrontmatterBlock(raw);
@@ -98,7 +94,7 @@ function recognize(c, file) {
         ownsPresentation: true,
         type: "website",
         name,
-        content: body.length > MAX_CONTENT_CHARS ? body.slice(0, MAX_CONTENT_CHARS) : body,
+        content: body,
     };
     if (fm.description !== undefined)
         doc.description = fm.description;

package/dist/core/adapter/validate-context.js

@@ -48,9 +48,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { assetPathForName, stashDirFor } from "../asset/asset-placement.js";
 import { typeNameFromConceptId } from "../asset/resolve-ref.js";
-function toPosix(p) {
-    return p.replace(/\\/g, "/");
-}
+import { toPosix } from "../common.js";
 /** Build the overlay map, keyed by POSIX path relative to `root`. */
 function buildOverlay(root, changes) {
     const overlay = new Map();

package/dist/core/asset/asset-placement.js

@@ -25,10 +25,8 @@
  */
 import fs from "node:fs";
 import path from "node:path";
+import { toPosix } from "../common.js";
 import { DERIVED_SUFFIX, SCRIPT_EXTENSIONS, WORKFLOW_EXTENSIONS } from "../recognition-util.js";
-function toPosix(input) {
-    return input.replace(/\\/g, "/");
-}
 const workflowSpec = {
     isRelevantFile: (fileName) => WORKFLOW_EXTENSIONS.includes(path.extname(fileName).toLowerCase()),
     toCanonicalName: (typeRoot, filePath) => {

package/dist/core/asset/frontmatter.js

@@ -323,6 +323,102 @@ export function removeFrontmatterListValues(raw, key, values) {
     }
     return changed ? out.join("\n") : null;
 }
+/**
+ * Rewrite specific VALUES in one frontmatter list key to new spellings,
+ * preserving every other byte — the rename counterpart to
+ * {@link removeFrontmatterListValues}, used by `akm lint --fix` to migrate
+ * retired `type:slug` xref values (`xrefs:`/`supersededBy:`/`contradictedBy:`)
+ * to their conceptId form once resolution confirms the rewritten spelling
+ * still points at a real asset.
+ *
+ * Handles the same three spellings a belief channel appears in: a block
+ * sequence, an inline flow, and a bare scalar. `replacements` maps an
+ * unquoted OLD value to its NEW value; a value not present in the map is left
+ * untouched byte-for-byte (including any quoting it had).
+ *
+ * Returns the rewritten source, or `null` when `raw` has no well-formed
+ * frontmatter block or nothing matched, so the caller can leave the file
+ * untouched. Deliberately source-preserving, like its sibling.
+ */
+export function rewriteFrontmatterListValue(raw, key, replacements) {
+    if (replacements.size === 0)
+        return null;
+    const lines = raw.split(/\r?\n/);
+    if (lines[0]?.trim() !== "---")
+        return null;
+    const closeIdx = lines.findIndex((l, i) => i > 0 && l.trim() === "---");
+    if (closeIdx === -1)
+        return null;
+    const out = [];
+    let changed = false;
+    let index = 0;
+    while (index < lines.length) {
+        const line = lines[index];
+        if (index === 0 || index >= closeIdx) {
+            out.push(line);
+            index += 1;
+            continue;
+        }
+        const kv = line.match(/^(\w[\w-]*):\s*(.*)$/);
+        if (kv === null || kv[1] !== key) {
+            out.push(line);
+            index += 1;
+            continue;
+        }
+        const rest = kv[2].trim();
+        // Inline flow: xrefs: [a, b]
+        const flow = rest.match(/^\[(.*)\]$/);
+        if (flow !== null) {
+            const items = flow[1].split(",").map((item) => item.trim());
+            const nextItems = items.map((item) => {
+                if (!item)
+                    return item;
+                const replacement = replacements.get(unquote(item));
+                if (replacement === undefined)
+                    return item;
+                changed = true;
+                return replacement;
+            });
+            out.push(items.length > 0 && items[0] !== "" ? `${kv[1]}: [${nextItems.join(", ")}]` : line);
+            index += 1;
+            continue;
+        }
+        // Bare scalar: xrefs: a
+        if (rest !== "") {
+            const replacement = replacements.get(unquote(rest));
+            if (replacement === undefined) {
+                out.push(line);
+            }
+            else {
+                changed = true;
+                out.push(`${kv[1]}: ${replacement}`);
+            }
+            index += 1;
+            continue;
+        }
+        // Block sequence: the key line, then `  - value` items.
+        out.push(line);
+        let cursor = index + 1;
+        while (cursor < closeIdx) {
+            const itemLine = lines[cursor];
+            const itemMatch = itemLine.match(/^(\s*-\s*)(.*)$/);
+            if (itemMatch === null)
+                break;
+            const [, prefix, value] = itemMatch;
+            const replacement = replacements.get(unquote(value));
+            if (replacement === undefined) {
+                out.push(itemLine);
+            }
+            else {
+                changed = true;
+                out.push(`${prefix}${replacement}`);
+            }
+            cursor += 1;
+        }
+        index = cursor;
+    }
+    return changed ? out.join("\n") : null;
+}
 /**
  * Parse a YAML scalar value (string, boolean, or number).
  *