opencode-agent-skill 11.0.0 → 13.0.0-beta.0

package/scripts/smoke-packed-install.mjs

@@ -96,7 +96,9 @@ try {
   assert.equal(state.package, packageName)
   assert.equal(state.version, packageJson.version)
   assert.ok(state.skills.length >= 39)
-  assert.ok(state.commands.length >= 11)
+  assert.deepEqual(state.commands, [])
+  assert.ok(state.promptAliases.length >= 11)
+  assert.ok(state.promptAliases.includes("ues-run"))
   assert.ok(state.agents.length >= 10)
   assert.equal(state.openCodeMajor, 2)
   assert.deepEqual(state.plugins, ["ues-router/index.js"])
@@ -106,8 +108,16 @@ try {
   assert.ok(existsSync(path.join(configDir, "plugins", "ues-router", "router.js")), "v2 router helper was not installed from packed package")
   assert.ok(existsSync(path.join(configDir, "plugins", "ues-router", "safety.js")), "v2 router safety gate was not installed from packed package")
   assert.ok(existsSync(path.join(configDir, "plugins", "ues-router", "capabilities.js")), "v8 router capability probe was not installed from packed package")
+  assert.ok(existsSync(path.join(configDir, "plugins", "ues-router", "parallel-runtime.js")), "v13 parallel runtime was not installed from packed package")
+  assert.ok(existsSync(path.join(configDir, "plugins", "ues-router", "text-runtime.js")), "v13 UTF-aware text runtime was not installed from packed package")
+  assert.ok(existsSync(path.join(configDir, "plugins", "ues-router", "verifier-runtime.js")), "v13 verifier runtime was not installed from packed package")
+  assert.ok(existsSync(path.join(configDir, "plugins", "ues-router", "command-runtime.js")), "v13 prompt alias runtime was not installed from packed package")
+  assert.ok(existsSync(path.join(configDir, "plugins", "ues-router", "command-templates", "run.md")), "v13 /ues-run prompt alias template was not installed from packed package")
+  assert.equal(existsSync(path.join(configDir, "commands", "ues-run.md")), false, "v2 install must not leave a native /ues-run custom command")
   const routerSource = await readFile(routerPlugin, "utf8")
   assert.match(routerSource, /name: "dispatch_task"/)
+  assert.match(routerSource, /name: "dispatch_parallel"/)
+  assert.match(routerSource, /name: "text_read"/)
   assert.match(routerSource, /ctx\.session\.create/)
   assert.match(routerSource, /ctx\.session\.switchAgent/)
   assert.match(routerSource, /ctx\.session\.switchModel/)
@@ -136,6 +146,32 @@ try {
   })
   requireSuccess(inspect, "ocskill inspect from packed copy")
 
+  const compactGraph = spawnSync(process.execPath, [cli, "repo-graph", temp, "--compact"], {
+    cwd: temp,
+    env,
+    encoding: "utf8",
+  })
+  requireSuccess(compactGraph, "ocskill compact repo-graph from packed copy")
+  const compactGraphPayload = JSON.parse(compactGraph.stdout)
+  assert.equal(typeof compactGraphPayload.nodeCount, "number")
+  assert.equal(typeof compactGraphPayload.edgeCount, "number")
+  assert.equal("nodes" in compactGraphPayload, false)
+  assert.equal("edges" in compactGraphPayload, false)
+
+  const utf16TextFile = path.join(temp, "legacy-plan.txt")
+  const utf16Body = "legacy UTF text from packed copy\n"
+  await writeFile(
+    utf16TextFile,
+    Buffer.concat([Buffer.from([0xff, 0xfe]), Buffer.from(utf16Body, "utf16le")]),
+  )
+  const textRead = spawnSync(process.execPath, [cli, "text-read", utf16TextFile, "--json"], {
+    cwd: temp,
+    env,
+    encoding: "utf8",
+  })
+  requireSuccess(textRead, "ocskill text-read from packed copy")
+  assert.equal(JSON.parse(textRead.stdout).text, utf16Body)
+
   const planFile = path.join(temp, "PLAN.json")
   await writeFile(planFile, JSON.stringify({
     schemaVersion: 1,
@@ -256,7 +292,7 @@ try {
     encoding: "utf8",
   })
   requireSuccess(workComplete, "ocskill work complete from packed copy")
-  assert.match(workComplete.stdout, /"evidenceStrength": "receipt-backed"/)
+  assert.match(workComplete.stdout, /"evidenceStrength": "command-receipt-backed"/)
 
   const finalizeBeforeVerify = spawnSync(process.execPath, [cli, "work", "finalize", "packed-smoke", temp, "--evidence", "should fail"], {
     cwd: temp,
@@ -453,7 +489,7 @@ try {
 
   console.log(
     `One-command packed install smoke passed for ${packageName}@${packageJson.version}: ` +
-      `${state.skills.length} skills, ${state.commands.length} commands, ${state.agents.length} subagents, ${state.plugins.length} v2 router plugin.`,
+      `${state.skills.length} skills, ${state.promptAliases.length} prompt aliases, ${state.agents.length} subagents, ${state.plugins.length} v2 router plugin.`,
   )
 } finally {
   await rm(temp, { recursive: true, force: true })

package/scripts/smoke-plain-install.mjs

@@ -65,26 +65,46 @@ try {
 
   const stateFile = path.join(configDir, ".ues", "state.json")
   const autoSynced = existsSync(stateFile)
+  let manualSyncFallback = false
+  if (!autoSynced) {
+    // npm 11+ may block third-party lifecycle scripts until the user explicitly
+    // allows them. The package must still leave a usable CLI that can perform
+    // the documented deterministic fallback without reinstalling the package.
+    const sync = spawnSync(process.execPath, [cli, "install"], {
+      cwd: temp,
+      env: { ...process.env, OPENCODE_CONFIG_DIR: configDir, UES_OPENCODE_MAJOR: "2" },
+      encoding: "utf8",
+    })
+    requireSuccess(sync, "manual ocskill resource sync fallback")
+    manualSyncFallback = true
+  }
+
   assert.equal(
-    autoSynced,
+    existsSync(stateFile),
     true,
-    "plain npm install installed the CLI but did not auto-sync OpenCode resources; one-command installation is not release-safe",
+    "global npm install did not produce a usable resource sync path",
   )
-
   const state = JSON.parse(await readFile(stateFile, "utf8"))
   assert.equal(state.package, packageName)
+  assert.equal(state.openCodeMajor, 2)
   assert.ok(state.skills.length >= 39)
-  assert.ok(state.commands.length >= 11)
+  assert.deepEqual(state.commands, [])
+  assert.ok(state.promptAliases.length >= 11)
+  assert.ok(state.promptAliases.includes("ues-run"))
   assert.ok(state.agents.length >= 10)
+  assert.ok(existsSync(path.join(configDir, "plugins", "ues-router", "command-runtime.js")))
+  assert.ok(existsSync(path.join(configDir, "plugins", "ues-router", "command-templates", "run.md")))
+  assert.equal(existsSync(path.join(configDir, "commands", "ues-run.md")), false)
 
   console.log(
     "Plain npm install compatibility smoke passed for " + packageName + "@" + packageJson.version +
     ": npm " + npmVersion + ", lifecycle auto-sync=" + autoSynced +
-    ", final resources=" + state.skills.length + "/" + state.commands.length + "/" + state.agents.length + ".",
+    ", manual sync fallback=" + manualSyncFallback +
+    ", final resources=" + state.skills.length + " skills/" + state.promptAliases.length + " prompt-aliases/" + state.agents.length + " agents.",
   )
 
-  if (Number.isFinite(npmMajor) && npmMajor >= 11) {
-    console.warn("[smoke] npm 11+ completed the one-command install and resource auto-sync contract.")
+  if (Number.isFinite(npmMajor) && npmMajor >= 11 && manualSyncFallback) {
+    console.warn("[smoke] npm 11+ blocked lifecycle auto-sync; documented 'ocskill install' fallback succeeded.")
   }
 } finally {
   await rm(temp, { recursive: true, force: true })

package/scripts/validate-repo-scale-suite.mjs

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import { mkdtemp, readFile, rm } from "node:fs/promises"
+import os from "node:os"
+import path from "node:path"
+import { fileURLToPath } from "node:url"
+import { generateRepoScaleFixture } from "../lib/repo-scale-fixture.mjs"
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..")
+const suite = JSON.parse(await readFile(path.join(root, "evals", "repo-scale", "tasks.json"), "utf8"))
+const errors = []
+if (!Array.isArray(suite.tasks) || suite.tasks.length < 4) errors.push("repo-scale suite must define at least 4 tasks")
+for (const task of suite.tasks || []) {
+  if (!task.id || !task.objective || task.objective.length < 40) errors.push((task.id || "<missing>") + ": objective too weak")
+  if (!Array.isArray(task.requiredFiles) || task.requiredFiles.length < 2) errors.push((task.id || "<missing>") + ": requiredFiles must contain at least 2 paths")
+  if (!Array.isArray(task.acceptance) || task.acceptance.length < 2) errors.push((task.id || "<missing>") + ": acceptance must contain at least 2 checks")
+}
+const tmp = await mkdtemp(path.join(os.tmpdir(), "ues-repo-scale-"))
+try {
+  const generated = await generateRepoScaleFixture(tmp)
+  if (generated.generatedModules < Number(suite.minimumGeneratedModules || 300)) errors.push("generated repo too small: " + generated.generatedModules + " modules")
+} finally { await rm(tmp, { recursive: true, force: true }) }
+if (errors.length) {
+  console.error("Repo-scale suite validation failed:")
+  for (const error of errors) console.error("- " + error)
+  process.exit(1)
+}
+console.log("Validated repo-scale suite: " + suite.tasks.length + " tasks, >=" + suite.minimumGeneratedModules + " generated modules.")

package/scripts/validate-v12-foundation.mjs

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+import { existsSync } from "node:fs"
+import { readFile } from "node:fs/promises"
+import path from "node:path"
+import { fileURLToPath } from "node:url"
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..")
+const errors = []
+const required = [
+  "lib/model-performance.mjs","lib/context-quality.mjs","lib/work-plan-scope.mjs",
+  "lib/decision-policy.mjs","lib/repo-scale-fixture.mjs","evals/repo-scale/tasks.json",
+  "scripts/validate-repo-scale-suite.mjs",
+]
+for (const relative of required) if (!existsSync(path.join(root, relative))) errors.push("missing V12 foundation file: " + relative)
+const pkg = JSON.parse(await readFile(path.join(root, "package.json"), "utf8"))
+for (const script of ["evals:v12:validate","evals:repo-scale:validate"]) if (!pkg.scripts?.[script]) errors.push("package.json missing script " + script)
+const tasks = JSON.parse(await readFile(path.join(root, "evals", "repo-scale", "tasks.json"), "utf8"))
+if ((tasks.tasks || []).length < 4) errors.push("V12 repo-scale suite needs at least 4 contract tasks")
+if (errors.length) {
+  console.error("V12 foundation validation failed:")
+  for (const error of errors) console.error("- " + error)
+  process.exit(1)
+}
+console.log("Validated V12 weak-model intelligence foundation files and repo-scale contracts.")

package/scripts/validate.mjs

@@ -98,12 +98,25 @@ const routerIndex = path.join(pluginsRoot, "ues-router", "index.js")
 const routerCore = path.join(pluginsRoot, "ues-router", "router.js")
 const routerSafety = path.join(pluginsRoot, "ues-router", "safety.js")
 const routerCapabilities = path.join(pluginsRoot, "ues-router", "capabilities.js")
+const routerParallelRuntime = path.join(pluginsRoot, "ues-router", "parallel-runtime.js")
+const routerTextRuntime = path.join(pluginsRoot, "ues-router", "text-runtime.js")
+const routerVerifierRuntime = path.join(pluginsRoot, "ues-router", "verifier-runtime.js")
+const routerCommandRuntime = path.join(pluginsRoot, "ues-router", "command-runtime.js")
 if (!existsSync(routerIndex)) errors.push("missing OpenCode v2 router plugin entrypoint")
 if (!existsSync(routerCore)) errors.push("missing OpenCode v2 router core")
 if (!existsSync(routerSafety)) errors.push("missing OpenCode v2 safety gate")
 if (!existsSync(routerCapabilities)) errors.push("missing OpenCode v2 runtime capability probe")
+if (!existsSync(routerParallelRuntime)) errors.push("missing V13 same-model parallel runtime")
+if (!existsSync(routerTextRuntime)) errors.push("missing V13 UTF-aware router text runtime")
+if (!existsSync(routerVerifierRuntime)) errors.push("missing V13 verifier verdict runtime")
+if (!existsSync(routerCommandRuntime)) errors.push("missing V13 V2 prompt alias runtime")
 if (existsSync(routerIndex)) {
   const source = await readFile(routerIndex, "utf8")
+  if (source.includes("@opencode/plugin")) errors.push("v2 router plugin must be self-contained and not require @opencode/plugin at runtime")
+  if (!source.includes("export default {")) errors.push("v2 router plugin must export a plain default plugin definition")
+  if (!source.includes("function spawnHidden")) errors.push("v2 router plugin must centralize subprocesses through spawnHidden")
+  if (!source.includes("windowsHide: true")) errors.push("v2 router plugin must hide Windows child-process consoles")
+  if ((source.match(/\bspawnSync\s*\(/g) || []).length !== 1) errors.push("v2 router plugin must not call spawnSync directly outside spawnHidden")
   if (!source.includes('id: "ues-router"')) errors.push("v2 router plugin must declare stable id ues-router")
   if (!source.includes('ctx.session.hook("prompt"')) errors.push("v2 router plugin must register prompt admission hook")
   if (!source.includes('ctx.session.hook("context"')) errors.push("v2 router plugin must register context guardrail hook")
@@ -125,6 +138,10 @@ if (existsSync(routerIndex)) {
   if (!source.includes('name: "visual_geometry"')) errors.push("v11 router plugin must expose visual geometry receipts")
   if (!source.includes('name: "visual_compare"')) errors.push("v11 router plugin must expose deterministic PNG comparison")
   if (!source.includes('name: "workflow_plan"')) errors.push("v11 router plugin must expose dynamic workflow planning")
+  if (!source.includes('name: "dispatch_parallel"')) errors.push("v13 router plugin must expose same-model parallel dispatch")
+  if (!source.includes("expandUesPromptAlias")) errors.push("v13 router plugin must expand UES slash aliases through session.prompt")
+  if (!source.includes("command-templates")) errors.push("v13 router plugin must load managed prompt alias templates")
+  if (!source.includes('name: "text_read"')) errors.push("v13 router plugin must expose UTF-aware text recovery")
   if (!source.includes('name: "ui_tokens"')) errors.push("v11 router plugin must expose compact design-token extraction")
   if (!source.includes('name: "ui_layout"')) errors.push("v11 router plugin must expose responsive UI layout verification")
   if (!source.includes("ctx.session.interrupt")) errors.push("v8 task dispatch must interrupt timed-out executors")
@@ -150,7 +167,7 @@ if (existsSync(plainInstallSmoke)) {
   }
 }
 
-for (const name of ["process-runner.mjs","evidence-receipt.mjs","gate-receipt.mjs","runtime-events.mjs","context-manifest.mjs","orchestrator-policy.mjs","worktree-sandbox.mjs","learning-engine.mjs","hermes-bridge.mjs","control-center.mjs","evidence-store.mjs","evidence-budget.mjs","prompt-cache.mjs","capability-registry.mjs","visual-spec.mjs","png-diff.mjs","browser-adapter.mjs","browser-runtime.mjs","dynamic-workflow.mjs","skill-quality.mjs","ui-inspector.mjs","context-engine-v11.mjs","v11-metrics.mjs"]) {
+for (const name of ["process-runner.mjs","evidence-receipt.mjs","gate-receipt.mjs","runtime-events.mjs","context-manifest.mjs","orchestrator-policy.mjs","worktree-sandbox.mjs","learning-engine.mjs","hermes-bridge.mjs","control-center.mjs","evidence-store.mjs","evidence-budget.mjs","prompt-cache.mjs","capability-registry.mjs","visual-spec.mjs","png-diff.mjs","browser-adapter.mjs","browser-runtime.mjs","dynamic-workflow.mjs","skill-quality.mjs","ui-inspector.mjs","context-engine-v11.mjs","v11-metrics.mjs","text-encoding.mjs"]) {
   if (!existsSync(path.join(root, "lib", name))) errors.push(`missing V8 core module ${name}`)
 }