akm-opencode 0.9.21202610012143 → 0.9.21202610040152

package/README.md

@@ -17,7 +17,7 @@ Add the plugin to `opencode.json`:
 | Tool | Description |
 | --- | --- |
 | `akm_search` | Search configured bundles or registries. `source` accepts `local`, `registry`, `all`, or a configured bundle name. |
-| `akm_show` | Show a concept by `[bundle//]conceptId[#fragment]`. Reads are exact by default; for an opaque search fragment, `context: "lead"` adds bounded indexed-safe lead context. |
+| `akm_show` | Show a concept by `[bundle//]conceptId[#fragment]`. |
 | `akm_curate` | Return ranked concepts for a task or topic. Optional `pack` is a token budget that returns the selected local assets' full content in one response; registry hits are omitted from packed items. |
 | `akm_feedback` | Record positive or negative feedback for a concept. |
 | `akm_remember` | Save durable knowledge as a searchable memory. |
@@ -26,13 +26,7 @@ Add the plugin to `opencode.json`:
 
 Use the `ref` returned by search or curate directly with show or feedback. When `akm_curate.pack` is set, the response already includes packed local content, so a separate show call is only needed for omitted or registry-only hits. Concept IDs look like `skills/code-review`, `memories/release-retro`, or `team-playbook//knowledge/deploy#Rollback`.
 
-For `akm_show`, `context` accepts `exact` or `lead`. Exact is the default and
-preserves the existing selected-fragment behavior. For an opaque fragment ref
-returned by search, lead context puts the indexed-safe first fragment before
-an explicitly labelled selected match and uses a 3,200-character default hard
-bound. Friendly authored heading selectors retain their existing source-live
-behavior. Set either `max_tokens` (estimated at four characters per token) or
-`max_chars`, never both. Search and show
+Search and show
 responses preserve canonical `ref` while exposing `selectedRef`, `parentRef`,
 fragment ordinal/count and lines, previous/next refs, separate fragment/parent
 estimates, and context truncation metadata.
@@ -85,7 +79,6 @@ Every kill switch below is opt-out and reads the same way: only the literal `0`
 | `AKM_AUTO_CURATE` | `1` | Set to `0` to disable automatic prompt curation. |
 | `AKM_AUTO_FEEDBACK` | `1` | Set to `0` to disable automatic feedback: the retrospective ("that worked") confirmation. |
 | `AKM_AUTO_LEARNING` | `1` | Set to `0` to disable prompt-signal capture and automatic learning/skill proposal submission. Native session extraction is controlled separately by `AKM_AUTO_MEMORY`. |
-| `AKM_AUTO_HINTS` | `1` | Set to `0` to skip the per-session `akm hints` call. The missing-bundle warning is deliberately not gated on this: it explains why the bundle is empty in the first place. |
 | `AKM_AUTO_MEMORY` | `1` | Set to `0` to disable interval-gated native-session extraction through `akm proposal extract`. The Claude plugin honours the same variable for its `SessionEnd` extraction. |
 | `AKM_INDEX_ON_SESSION_END` | `1` | Set to `0` to skip the `akm index` refresh. It runs only on `session.deleted` — never on `session.idle`, which fires after every turn. |
 | `AKM_WRITE_GATE` | `observe` | The format-declaration write gate (#99). When a file the session **read** declares a format your bundle documents — an `apiVersion:` namespace, a `yaml-language-server` pragma, a `$schema` key, an XML root namespace — and that asset has not been opened this session, the FIRST `edit`/`write` to that file is blocked once and the model is told which ref to read. It ships in `observe`: everything runs and the would-fire count lands in the ledger, but nothing is blocked. Set `enforce` to block, or `off`/`0` to disable it entirely. An unrecognized value is a configuration error — it logs one error per process and the gate refuses to run rather than guessing a default. It never fires on a file this session created: the create is recorded when it happens — a `write` to a path this session has not read, or an `edit` with an empty `oldString` — and that path stays insulated for the rest of the session, so reading back the model's own output does not re-arm it (ledger reason `session-created`). It is inert on `apply_patch` (which carries no file path) — that case logs one warning per process rather than failing quietly. |
@@ -138,7 +131,7 @@ These three are read once, when the plugin module is imported, so they must be s
 
 1. Start with `akm_curate` for task-oriented discovery; set `pack` when you want the selected local content immediately.
 2. Use `akm_search` when you know the concept name and need its exact ID.
-3. Fetch a concept with `akm_show` before relying on it; opt into bounded lead context only when a selected fragment needs it.
+3. Fetch a concept with `akm_show` before relying on it.
 4. Record whether the concept helped with `akm_feedback`; a failed akm call is not feedback on the asset.
 5. Use `akm_remember` for durable knowledge that should be available to future sessions.
 

package/dist/index.js

@@ -1163,61 +1163,12 @@ function shouldRecall(prompt, options) {
   return { shouldRecall: false, reason: "skip-low-signal", query: text, scopeHints };
 }
 
-// fragment-context.ts
-function positiveSafeInteger(value, field) {
-  if (value === undefined)
-    return;
-  if (typeof value !== "number" || !Number.isSafeInteger(value) || value <= 0) {
-    throw new Error(`${field} must be a positive integer`);
-  }
-  return value;
-}
-function supportsFragmentLeadContext(version) {
-  const match = /^(\d+)\.(\d+)\.(\d+)/.exec(version.trim());
-  if (!match)
-    return false;
-  const major = Number(match[1]);
-  const minor = Number(match[2]);
-  const patch = Number(match[3]);
-  return major > 0 || minor > 9 || minor === 9 && patch >= 15;
-}
-function normalizeFragmentShowInput(input, loadedAkmApiVersion) {
-  const {
-    context,
-    max_tokens: rawMaxTokens,
-    max_chars: rawMaxChars,
-    ...showInput
-  } = input;
-  const maxTokens = positiveSafeInteger(rawMaxTokens, "max_tokens");
-  const maxChars = positiveSafeInteger(rawMaxChars, "max_chars");
-  if (maxTokens !== undefined && maxChars !== undefined) {
-    throw new Error("max_tokens and max_chars are mutually exclusive");
-  }
-  const contextMode = context;
-  if (contextMode === "lead" && !supportsFragmentLeadContext(loadedAkmApiVersion)) {
-    throw new Error(`context='lead' requires akm-cli >=0.9.15; this plugin bundles ${loadedAkmApiVersion}. ` + "Install the plugin release whose exact akm-cli pin is 0.9.15 or newer.");
-  }
-  const maxContextChars = maxChars ?? (maxTokens !== undefined ? maxTokens * 4 : undefined);
-  if (maxContextChars !== undefined && !Number.isSafeInteger(maxContextChars)) {
-    throw new Error("fragment context budget is too large");
-  }
-  if (maxContextChars !== undefined && contextMode !== "lead") {
-    throw new Error("max_tokens and max_chars require context='lead'");
-  }
-  return {
-    ...showInput,
-    ...contextMode !== undefined ? { contextMode } : {},
-    ...maxContextChars !== undefined ? { maxContextChars } : {}
-  };
-}
-
 // index.ts
 var moduleDir = path4.dirname(fileURLToPath(import.meta.url));
 var AKM_AUTO_FEEDBACK = (process.env.AKM_AUTO_FEEDBACK ?? "1") !== "0";
 var AKM_AUTO_LEARNING = (process.env.AKM_AUTO_LEARNING ?? "1") !== "0";
 var AKM_AUTO_SKILL_PROPOSALS = (process.env.AKM_AUTO_SKILL_PROPOSALS ?? "1") !== "0";
 var AKM_AUTO_CURATE = (process.env.AKM_AUTO_CURATE ?? "1") !== "0";
-var AKM_AUTO_HINTS = (process.env.AKM_AUTO_HINTS ?? "1") !== "0";
 var AKM_PENDING_PROPOSAL_TIMEOUT_MS = Math.max(500, (Number(process.env.AKM_PENDING_PROPOSAL_TIMEOUT ?? "2") || 2) * 1000);
 var AKM_CURATE_LIMIT = Math.max(1, Number(process.env.AKM_CURATE_LIMIT ?? "5") || 5);
 var AKM_CURATE_MIN_CHARS = Math.max(1, Number(process.env.AKM_CURATE_MIN_CHARS ?? "16") || 16);
@@ -1275,19 +1226,6 @@ var pendingProposalSummaryCache = new Map;
 var retrospectiveState = new Map;
 var cachedAkmBundleDir;
 var PROPOSED_QUALITY_WARNING = "Do not treat proposed assets as curated until accepted.";
-var AKM_WORKFLOW_INSTRUCTION = [
-  "# AKM workflow (v0.9.21)",
-  "",
-  "Use AKM as a reusable knowledge and workflow bundle.",
-  "",
-  "Before writing or editing anything whose exact syntax or keys you are not certain of (a file already in the workspace included):",
-  "1. Use `akm_curate` with a query that includes the current project name/domain (primary discovery). Fall back to `akm_search` only when you already know an asset exists and need its exact ref.",
-  "2. Use `akm_show <ref>` before relying on an asset.",
-  "3. Record `akm_feedback` after the result is known.",
-  "4. Use `akm_remember` to preserve durable project knowledge.",
-  `5. ${PROPOSED_QUALITY_WARNING}`
-].join(`
-`);
 function readPackageVersion() {
   try {
     const raw = readFileSync3(path4.join(moduleDir, "package.json"), "utf8");
@@ -2420,19 +2358,9 @@ function warnIfWriteGateInert(client) {
 var AKM_HINTS_PREFIX = [
   "# AKM is available in this session",
   "",
-  "You have an AKM bundle on this machine. Before writing **or editing** a config file, manifest, schema, or command for any tool, format, or API whose exact syntax or keys you are not certain of, call `akm_curate` with a task description to find relevant assets with LLM-reranked relevance scores. A file already being present in the workspace is not evidence that you know its schema \u2014 the values may be given to you while the key names and nesting are not, so check the bundle for that format's conventions before you edit it.",
-  "",
-  "**Choosing the right lookup command:**",
-  "",
-  "- **`akm_curate`** \u2014 use this when starting any new task, looking for patterns, docs, skills, or workflows. This is the PRIMARY lookup command. akm automatically boosts assets that match the current project (cwd-anchored project-context ranking), so an explicit project name in the query is not required for ranking \u2014 but it still helps the reranker frame intent.",
-  '  - Good: `akm_curate("akm CLI improve command performance analysis")` (explicit framing, still ideal)',
-  '  - Bad: `akm_curate("improve performance analysis")` (too generic \u2014 the reranker has less to work with even with auto-boost)',
-  '- **`akm_search` (known name)** \u2014 use ONLY when you already know an asset exists (e.g. after `akm_show` returned "not found") and need to locate its exact ref. Do not use as a discovery tool.',
-  "- **`akm_show <bundle>//meta`** \u2014 when working in or with an unfamiliar bundle, read its optional `.meta/` orientation (purpose, key assets, conventions, maintainer) before diving in. `akm_show meta` reads your working bundle's `.meta/index.md`; `akm_show meta:<name>` reads other `.meta/` docs (e.g. `meta:about`). These docs are direct-read and never appear in `akm_search`.",
-  "",
-  "When an asset's content is wrong, stale or incomplete, call `akm_feedback <ref> negative` with a note saying <what is wrong and what should change>: negative feedback is what triggers a review and fix of the asset, so make the note specific. Call it with `positive` when an asset materially helped (it only improves ranking). A failed akm call is not feedback on the asset. Use `akm_remember` to persist durable learnings so future sessions inherit them.",
-  "",
-  AKM_WORKFLOW_INSTRUCTION
+  "- Assets for this project (skills, knowledge, memories, workflows) live in the AKM bundle. Before writing or editing a file whose format or keys you are not sure of, find them with `akm_curate` (by task) or `akm_search` (by name), and read one with `akm_show` before relying on it.",
+  "- Record `akm_feedback` on an asset once you know whether it helped; keep durable project knowledge with `akm_remember`.",
+  "- `akm hints` has this bundle's conventions; `akm help` has the CLI."
 ].join(`
 `);
 var AKM_CURATED_TAIL = "\n\nTip: call `akm_show <ref>` to fetch full content. If an asset is wrong, stale or incomplete, call `akm_feedback <ref> negative` with a note saying <what is wrong and what should change>: that queues it for review and a fix. Use `positive` when it helped.";
@@ -2922,8 +2850,7 @@ async function runInProcess(client, operation, input, meta) {
     if (operation === "curate" && input.pack !== undefined && (typeof input.pack !== "number" || !Number.isInteger(input.pack) || input.pack <= 0)) {
       throw new Error("pack must be a positive integer token budget");
     }
-    const normalizedInput = operation === "show" ? normalizeFragmentShowInput(input, BUNDLED_AKM_API_VERSION) : input;
-    const result = operation === "search" ? await akmSearch(normalizedInput) : operation === "show" ? await akmShowUnified(normalizedInput) : await (async () => {
+    const result = operation === "search" ? await akmSearch(input) : operation === "show" ? await akmShowUnified(input) : await (async () => {
       const { pack, ...curateInput } = input;
       const curated = await akmCurate(curateInput);
       return typeof pack === "number" ? packCuratedHits(curated, pack) : curated;
@@ -3110,7 +3037,7 @@ var akmPlugin = async ({ client, worktree, directory }) => {
           }
           if (!sessionHints.has(sid)) {
             const bundleWarning = await getAkmBundleWarning(logClient);
-            const hints = AKM_AUTO_HINTS ? await runHintsForSession(logClient, sid) : null;
+            const hints = await runHintsForSession(logClient, sid);
             const body = [bundleWarning, hints].filter(Boolean).join(`
 
 `);
@@ -3441,22 +3368,13 @@ ${hint}` : hint;
         }
       }),
       akm_show: tool({
-        description: "Show an AKM asset by [bundle//]conceptId[#fragment]. Reads stay exact by default. For an opaque fragment ref returned by search, context='lead' prepends bounded indexed-safe lead context and labels the selected match last; authored heading selectors retain their existing source-live behavior. Read an asset this way before relying on it, then record akm_feedback once you know whether it helped.",
+        description: "Show an AKM asset by [bundle//]conceptId[#fragment]. Read an asset this way before relying on it, then record akm_feedback once you know whether it helped.",
         args: {
           ref: tool.schema.string().describe("Asset ref returned by akm_curate or akm_search, optionally with a #fragment \u2014 e.g. `skills/code-review` or `local//knowledge/deploy#Rollback`."),
-          detail: tool.schema.enum(["brief", "summary", "normal", "full"]).optional().describe("Response detail level. Defaults to 'normal'."),
-          context: tool.schema.enum(["exact", "lead"]).optional().describe("Fragment context mode. Defaults to exact. For an opaque search fragment, use lead to prepend indexed-safe lead context while keeping the selected match last."),
-          max_tokens: tool.schema.number().optional().describe("Positive token budget for context='lead', estimated as four characters per token. Mutually exclusive with max_chars."),
-          max_chars: tool.schema.number().optional().describe("Positive character budget for context='lead'. Mutually exclusive with max_tokens. Lead defaults to 3200 characters.")
+          detail: tool.schema.enum(["brief", "summary", "normal", "full"]).optional().describe("Response detail level. Defaults to 'normal'.")
         },
-        async execute({ ref, detail, context, max_tokens, max_chars }, toolContext) {
-          return runInProcess(client, "show", {
-            ref,
-            detail,
-            context,
-            max_tokens,
-            max_chars
-          }, { toolName: "akm_show", sessionID: toolContext.sessionID, directory: toolContext.directory });
+        async execute({ ref, detail }, toolContext) {
+          return runInProcess(client, "show", { ref, detail }, { toolName: "akm_show", sessionID: toolContext.sessionID, directory: toolContext.directory });
         }
       }),
       akm_remember: tool({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akm-opencode",
-  "version": "0.9.21202610012143",
+  "version": "0.9.21202610040152",
   "type": "module",
   "description": "OpenCode plugin for AKM with discovery tools, feedback, memory, and automatic learning proposals from corrections and recurring workflows.",
   "keywords": [