@snarkipus/opencode-beads 1.1.0-beta.3 → 1.1.0-beta.5

package/README.md

@@ -11,7 +11,7 @@
 
 This is an independent project maintained by Matt Jackson under the MIT license. It began as a fork of [Josh Thomas's `opencode-beads`](https://github.com/joshuadavidthomas/opencode-beads), and the original work remains credited to its author. 1.0 rebuilt the plugin for OpenCode 2, and development now continues here independently. It vendors nothing from upstream Beads; instead, every Beads release is checked against the `bd` behavior the plugin relies on (see [Tracking upstream Beads](#tracking-upstream-beads)).
 
-This release is **1.1.0-beta.3**, an opt-in beta targeting npm dist-tag `next`; its integration diagnostic command is `oc-beads:diagnostics`. Beta.1 used `oc-beads:status`; the rename is documented below. The beta's normal public entrypoint enables the eleven qualified operations in the native `beads` code-mode namespace on supported hosts: find, get, edges, memories, recall, claim, note, selected-field update, close, create and remember. No wrapper, internal dependency injection, manual skill copy or activation setting is needed. The opt-in is selecting the beta artifact. The published stable 1.0.2 package is unchanged.
+This release is **1.1.0-beta.5**, an opt-in beta targeting npm dist-tag `next`; its integration diagnostic command is `oc-beads:diagnostics`. Beta.1 used `oc-beads:status`; the rename is documented below. The beta's normal public entrypoint enables the eleven qualified operations in the native `beads` code-mode namespace on supported hosts: find, get, edges, memories, recall, claim, note, selected-field update, close, create and remember. No wrapper, internal dependency injection, manual skill copy or activation setting is needed. The opt-in is selecting the beta artifact. The published stable 1.0.2 package is unchanged.
 
 The beta registers 29 `oc-beads:<stem>` workflows plus `oc-beads:diagnostics` through ordinary native command registration and owns its packaged `oc-beads` skill at the installed path, with all 15 corpus resources plus CODE_MODE and ADR (17 links). User configuration/file commands retain native precedence on load and rebuild; removing an override restores the package definition. Other plugin conflicts follow native ordering. Diagnostics reports observed registration and name/description mismatches; identical-description overrides and public owner identity remain unobservable.
 
@@ -45,7 +45,7 @@ The beta requires OpenCode `>=2.1.1 <2.2` and `bd` 1.3.1 or later. Exact OpenCod
 
    ```json
    {
-     "plugins": ["@snarkipus/opencode-beads@1.1.0-beta.3"]
+     "plugins": ["@snarkipus/opencode-beads@1.1.0-beta.5"]
    }
    ```
 
@@ -63,7 +63,7 @@ Plugin options use the object form:
 {
   "plugins": [
     {
-      "package": "@snarkipus/opencode-beads@1.1.0-beta.3",
+      "package": "@snarkipus/opencode-beads@1.1.0-beta.5",
       "options": { "luna": true, "autoMigrate": false }
     }
   ]
@@ -131,6 +131,22 @@ explicit modes and parent acceptance still apply. Guide/report commands produce
 their advertised artifact. This action-contract correction starts with beta.3;
 earlier beta artifacts do not contain this correction.
 
+Beta.4 keeps all 29 `/oc-beads:<workflow>` invocations compact, with
+single-line free text inline and multiline text below, preserving whitespace.
+Full static instructions live in durable `ocBeadsWorkflow` message metadata,
+expanded by existing primary and compaction hooks; retained `ocBeadsSync` v1
+history remains readable. Attachments/skills, prompt hooks and native delivery
+remain normal inputs. Starting with beta.5, diagnostics also uses compact history:
+its dynamic observed report is captured once into the same metadata/hook path,
+without adding store access. Its answer includes the loaded plugin name/version
+from the installed package manifest alongside the observed OpenCode host version.
+A version label alone is not a unique canary build fingerprint.
+Plugin activation is required for expansion; summaries retain semantic context,
+not guaranteed verbatim snapshots. Native storage/estimates can include copies or
+miss hidden text; this is not a token-savings claim. See the
+[workflow evaluation](docs/workflow-native-context-evaluation.md) and original
+[sync design](docs/sync-native-context-plan.md) / [evaluation](docs/sync-native-context-evaluation.md).
+
 Starting with beta.2, the package-owned `oc-beads:status` is removed without an alias. Use `oc-beads:diagnostics` for integration health and `oc-beads:stats` for the issue-database overview via `bd status` (alias `bd stats`). User-defined old status overrides are untouched and are not migrated; the package does not edit configuration.
 
 `oc-beads:compact` guides semantic issue compaction with `bd admin compact`; `bd compact` squashes Dolt history and is a different operation. Neither is conversation compaction. A bare invocation explains the workflow; a sufficiently specified semantic apply request supplies its bounded authority under actual permissions and policy. See the packaged [compact guidance](assets/oc-beads/resources/TROUBLESHOOTING.md) for mode/actor boundaries and upstream help uncertainty. `oc-beads:restore` retrieves pre-compaction issue content, displaying it by default; `--apply` requires explicit authority to write it back and does not mean database backup recovery. Quickstart uses installed help and authorized context; sync guides Dolt-remote synchronization, distinct from `bd federation sync`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snarkipus/opencode-beads",
-  "version": "1.1.0-beta.3",
+  "version": "1.1.0-beta.5",
   "type": "module",
   "description": "A maintained OpenCode V2 integration for the Beads issue tracker: bd prime context injection with a schema-migration guard, and a bounded task agent.",
   "author": "Matt Jackson",

package/src/guidance.ts

@@ -73,6 +73,7 @@ Beads workflow context could not be loaded: \`bd prime\` ${reason}. Beads may st
 /** Added to compaction requests so the summary keeps the Beads work in flight. */
 export const BEADS_COMPACTION_GUIDANCE = `<beads-compaction>
 This session tracks work in Beads (bd). Carry acknowledged durable task/memory references, current scope, attempts, blockers, pending validation and known unsaved or uncertain gaps into the summary or native-provider context. A summary is not a Beads write. Do not persist, wait for permission or a queued write, or request a recursive same-session checkpoint during compaction. Earlier meaningful checkpoints support recovery; no final-write guarantee applies. Fresh guarded context is requested after compaction. Preserve host-owned native replay, metadata.keepID and legacy metadata.recent; do not inject result.native.messages or a replacement result to add references.
+Preserve an active /oc-beads workflow invocation's requested outcome, unresolved inputs or explicit modes, and applicable authority limits in the summary.
 </beads-compaction>`;
 
 /** Observed after native request filtering; selective operation permission remains per call. */

package/src/host.ts

@@ -1,5 +1,6 @@
 import type { Plugin } from "@opencode/plugin";
-import { applyBeadsSkill, createBeadsCommands, loadBeadsSkill, type SkillLoadDependencies } from "./workflows";
+import packageManifest from "../package.json";
+import { applyBeadsSkill, createBeadsCommands, expandBeadsWorkflowContext, loadBeadsSkill, type SkillLoadDependencies } from "./workflows";
 import { applyBeadsAgents, beadsAgents, BEADS_TASK_AGENTS } from "./agents";
 import { BEADS_COMPACTION_GUIDANCE, UNKNOWN_CAPABILITIES, type RequestCapabilities } from "./guidance";
 import {
@@ -254,6 +255,7 @@ export async function setupBeads(
         try { effectiveSkills = ctx.skill ? (await ctx.skill.list()).data.map((entry) => String(entry.id)) : "unavailable"; }
         catch { effectiveSkills = "unavailable: registry lookup failed"; }
         return JSON.stringify({
+          plugin: { name: packageManifest.name, version: packageManifest.version },
           host: hostVersion, admission: SUPPORTED_OPENCODE_RANGE, liveQualification: "not measured by diagnostics; see release acceptance evidence",
           commands: {
             registration: commandRegistration,
@@ -334,6 +336,7 @@ export async function setupBeads(
 
     registrations.push(await ctx.session.hook("context", async (event) => {
       if (abort.signal.aborted) return;
+      expandBeadsWorkflowContext(event.messages);
       if (ctx.session.get) {
         try {
           const info = await ctx.session.get({ sessionID: event.sessionID });
@@ -373,7 +376,9 @@ export async function setupBeads(
     }));
 
     registrations.push(await ctx.session.hook("compaction", (event) => {
-      if (!abort.signal.aborted && beadsSessions.get(event.sessionID)?.has(event.agent)) {
+      if (abort.signal.aborted) return;
+      expandBeadsWorkflowContext(event.messages);
+      if (beadsSessions.get(event.sessionID)?.has(event.agent)) {
         event.system.push({ type: "text", text: BEADS_COMPACTION_GUIDANCE });
         const known = references.get(event.sessionID);
         const gap = gapFor(event.sessionID);

package/src/workflows.ts

@@ -2,6 +2,7 @@ import { readFile } from "node:fs/promises";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import type { Plugin } from "@opencode/plugin";
+import type { SessionContext } from "@opencode/plugin/promise/session";
 import type { CommandDefinition } from "@opencode/plugin/promise/command";
 
 type SkillEditor = Parameters<Parameters<Plugin.Context["skill"]["transform"]>[0]>[0];
@@ -87,7 +88,29 @@ export function applyBeadsSkill(editor: SkillEditor, skill: BeadsSkill, diagnose
   editor.add(skill);
 }
 
-/** Build native prompt commands, never shell/template interpolation or synthetic continuation. */
+/** Expand supported workflow/legacy snapshots only in transient user request copies. */
+export function expandBeadsWorkflowContext(messages: SessionContext["messages"]): void {
+  for (const [index, message] of messages.entries()) {
+    if (message.role !== "user") continue;
+    const metadata = { ...message.metadata };
+    let instructions: string | undefined;
+    for (const key of ["ocBeadsSync", "ocBeadsWorkflow"]) {
+      const snapshot = metadata[key];
+      if (!snapshot || typeof snapshot !== "object" || !("version" in snapshot) || snapshot.version !== 1
+        || !("instructions" in snapshot) || typeof snapshot.instructions !== "string") continue;
+      instructions = snapshot.instructions;
+      delete metadata[key];
+    }
+    if (instructions === undefined) continue;
+    messages[index] = {
+      ...message,
+      metadata,
+      content: [{ type: "text", text: instructions }, ...message.content],
+    };
+  }
+}
+
+/** Build native prompt commands with compact text and durable static workflow instructions. */
 export function createBeadsCommands(
   session: Pick<Plugin.Context["session"], "prompt">,
   diagnostics: (sessionID: string) => Promise<string>,
@@ -109,11 +132,13 @@ export function createBeadsCommands(
     description: purpose,
     async execute(input) {
       if (signal?.aborted) throw new Error("Beads workflow unloaded");
+      const instructions = `Invoked command: /oc-beads:${stem}\nRequested outcome: ${purpose}\n${common}\nSupporting guidance: ${JSON.stringify(resolve(dirname(skillPath), "resources", `${resource}.md`))}`;
       await session.prompt({
         ...input.prompt,
         sessionID: input.sessionID,
         delivery: input.delivery,
-        text: `Invoked command: /oc-beads:${stem}\nRequested outcome: ${purpose}\n${common}\nSupporting guidance: ${JSON.stringify(resolve(dirname(skillPath), "resources", `${resource}.md`))}${input.prompt.text ? `\n\nLiteral user details:\n${input.prompt.text}` : ""}`,
+        text: `/oc-beads:${stem}${input.prompt.text ? `${/[\r\n]/.test(input.prompt.text) ? "\n" : " "}${input.prompt.text}` : ""}`,
+        metadata: { ocBeadsWorkflow: { version: 1, instructions } },
       });
     },
   }));
@@ -126,7 +151,8 @@ export function createBeadsCommands(
       if (signal?.aborted) throw new Error("Beads workflow unloaded");
       await session.prompt({
         ...input.prompt, sessionID: input.sessionID, delivery: input.delivery,
-        text: `Report these observed Beads diagnostics. This is read-only; do not run store-opening commands, change configuration or infer live qualification.\n${report}\n\nUser request:\n${input.prompt.text}`,
+        text: `/oc-beads:diagnostics${input.prompt.text ? `${/[\r\n]/.test(input.prompt.text) ? "\n" : " "}${input.prompt.text}` : ""}`,
+        metadata: { ocBeadsWorkflow: { version: 1, instructions: `Report these observed Beads diagnostics. This is read-only; do not run store-opening commands, change configuration or infer live qualification.\n${report}\nInclude the loaded plugin name/version and observed OpenCode host version near the start of your report. Preserve unavailable, withheld and uncertain observations; do not infer a unique build identity from a version label.` } },
       });
     },
   });