opencode-plugin-flow 3.3.17 → 3.3.18

package/CHANGELOG.md

@@ -6,6 +6,10 @@ the rejected alternatives, and the validation that was run — see
 
 ## [Unreleased]
 
+## [3.3.18] - 2026-06-14
+
+Split the context-pack, markdown render, and distribution sync hotspots into smaller owner-named modules while preserving the public package, runtime, and workflow surfaces.
+
 ## [3.3.17] - 2026-06-14
 
 Teach every Flow skill to use one shared read-only parallel orchestration protocol, bundle the shared references, and lock recovery-code documentation to the runtime matrix.

package/README.md

@@ -31,7 +31,7 @@ Add Flow to the `plugin` array in your `opencode.json` (global `~/.config/openco
 
 ```json
 {
-  "plugin": ["opencode-plugin-flow@3.3.17"]
+  "plugin": ["opencode-plugin-flow@3.3.18"]
 }
 ```
 

package/dist/cli.js

@@ -1,19 +1,19 @@
 #!/usr/bin/env node
-import{homedir as he}from"node:os";import{readdir as ae,readFile as ie,rm as h,rmdir as se}from"node:fs/promises";import{dirname as oe,join as l,normalize as ne,sep as re}from"node:path";var X={fast:"low",balanced:"medium",deep:"high"},j={"flow-reviewer":{mode:"all",description:"Review Flow work read-only and record a reviewer decision.",prompt:"You are the Flow reviewer. Load the `flow-review` skill, review the requested work read-only, then record your decision with flow_review_record.",reasoningEffort:X.deep,permission:{edit:"deny",bash:"deny",task:{"*":"deny"},"flow_*":"deny",flow_status:"allow",flow_review_record:"allow"}}},W={"flow-plan":{description:"Create, update, or approve a Flow plan",template:"Load the `flow-plan` skill and plan: $ARGUMENTS"},"flow-run":{description:"Run one approved Flow feature",template:"Load the `flow-run` skill and execute the next approved Flow feature. $ARGUMENTS"},"flow-auto":{description:"Drive the Flow loop autonomously until completion or a real blocker",template:"Load the `flow` skill and drive the Flow loop (status, plan, run, review) until completion or a real blocker: $ARGUMENTS"},"flow-status":{description:"Inspect the active Flow session and workspace readiness",template:"Call flow_status (detailed) and report session state, readiness checks, and the suggested next step."},"flow-review":{description:"Run a read-only Flow review with a fresh context",agent:"flow-reviewer",subtask:!0,template:"Load the `flow-review` skill and review: $ARGUMENTS"}},k=["flow-doctor","flow-history","flow-reset","flow-session"];import{createHash as J}from"node:crypto";import{join as w}from"node:path";var x=w(".config","opencode","skills"),g=w(".config","opencode","commands"),_=w(".config","opencode","agents"),v=".flow-skill-version",E="SKILL.md.backup",R=w(".config","opencode","plugins","flow.js"),A=`// Managed by flow-opencode install/uninstall
-`,N="flow-opencode-generated-skill",Z=`<!-- ${N} `,$=new RegExp(`^<!-- ${N} name=([a-z0-9]+(?:-[a-z0-9]+)*) version=([0-9]+) hash=sha256:([a-f0-9]{64}) -->$`,"u");function f(e){return J("sha256").update(e,"utf8").digest("hex")}function m(e){let t=e.split(`
-`),i=t.flatMap((u,M)=>u.startsWith(Z)?[M]:[]);if(i.length===0)return{kind:"not_generated"};if(i.length>1)return{kind:"invalid_generated",reason:"duplicate_marker"};let a=i[0];if(a===void 0)return{kind:"not_generated"};let s=t[a];if(s===void 0)return{kind:"invalid_generated",reason:"malformed_marker"};let o=s.match($);if(!o)return{kind:"invalid_generated",reason:"malformed_marker"};let[,n,r,d]=o;if(n===void 0||r===void 0||d===void 0)return{kind:"invalid_generated",reason:"malformed_marker"};let c=[...t.slice(0,a),...t.slice(a+1)].join(`
-`);if(f(c)!==d)return{kind:"invalid_generated",reason:"hash_mismatch"};return{kind:"valid_generated",marker:{name:n,version:r,hash:d}}}var z="opencode-plugin-flow",O="file=",B="=sha256:";function y(e){let t=new Map;for(let i of e.split(`
-`)){if(!i.startsWith(O))continue;let a=i.slice(O.length),s=a.lastIndexOf(B);if(s===-1)continue;let o=a.slice(0,s),n=a.slice(s+B.length);if(o.length>0&&/^[a-f0-9]{64}$/.test(n))t.set(o,n)}return t}function b(e,t,i){let a=new Map;for(let n of e.split(`
-`)){let r=n.indexOf("=");if(r===-1)continue;a.set(n.slice(0,r),n.slice(r+1))}let s=a.get("version"),o=a.get("hash");if(a.get("plugin")!==z||a.get("kind")!==t||a.get("name")!==i||!s||!o?.startsWith("sha256:"))return null;return{kind:t,name:i,version:s,hash:o.slice(7)}}function T(e){let t=new Map;for(let o of e.split(`
-`)){let n=o.indexOf("=");if(n===-1)continue;t.set(o.slice(0,n),o.slice(n+1))}let i=t.get("plugin"),a=t.get("version");if(i!==z||!a)return null;let s=t.get("hash");return{plugin:i,version:a,hash:s?.startsWith("sha256:")?s.slice(7):null}}import{mkdir as De,readFile as K,rm as F,writeFile as et}from"node:fs/promises";import{dirname as at,join as C,sep as it}from"node:path";function D(e){return`${["---",`description: ${JSON.stringify(e.description)}`,...e.agent?[`agent: ${JSON.stringify(e.agent)}`]:[],...e.subtask===void 0?[]:[`subtask: ${e.subtask}`],"---"].join(`
+import{homedir as ge}from"node:os";import{readdir as de,readFile as ce,rm as u,rmdir as le}from"node:fs/promises";import{dirname as ue,join as c,normalize as he,sep as pe}from"node:path";var M={fast:"low",balanced:"medium",deep:"high"},V={"flow-reviewer":{mode:"all",description:"Review Flow work read-only and record a reviewer decision.",prompt:"You are the Flow reviewer. Load the `flow-review` skill, review the requested work read-only, then record your decision with flow_review_record.",reasoningEffort:M.deep,permission:{edit:"deny",bash:"deny",task:{"*":"deny"},"flow_*":"deny",flow_status:"allow",flow_review_record:"allow"}}},G={"flow-plan":{description:"Create, update, or approve a Flow plan",template:"Load the `flow-plan` skill and plan: $ARGUMENTS"},"flow-run":{description:"Run one approved Flow feature",template:"Load the `flow-run` skill and execute the next approved Flow feature. $ARGUMENTS"},"flow-auto":{description:"Drive the Flow loop autonomously until completion or a real blocker",template:"Load the `flow` skill and drive the Flow loop (status, plan, run, review) until completion or a real blocker: $ARGUMENTS"},"flow-status":{description:"Inspect the active Flow session and workspace readiness",template:"Call flow_status (detailed) and report session state, readiness checks, and the suggested next step."},"flow-review":{description:"Run a read-only Flow review with a fresh context",agent:"flow-reviewer",subtask:!0,template:"Load the `flow-review` skill and review: $ARGUMENTS"}},R=["flow-doctor","flow-history","flow-reset","flow-session"];import{createHash as D}from"node:crypto";import{join as g}from"node:path";var A=g(".config","opencode","skills"),m=g(".config","opencode","commands"),T=g(".config","opencode","agents"),v=".flow-skill-version",Y="SKILL.md.backup",q=g(".config","opencode","plugins","flow.js"),S=`// Managed by flow-opencode install/uninstall
+`,X="flow-opencode-generated-skill",L=`<!-- ${X} `,ee=new RegExp(`^<!-- ${X} name=([a-z0-9]+(?:-[a-z0-9]+)*) version=([0-9]+) hash=sha256:([a-f0-9]{64}) -->$`,"u");function h(e){return D("sha256").update(e,"utf8").digest("hex")}function y(e){let t=e.split(`
+`),i=t.flatMap((p,E)=>p.startsWith(L)?[E]:[]);if(i.length===0)return{kind:"not_generated"};if(i.length>1)return{kind:"invalid_generated",reason:"duplicate_marker"};let a=i[0];if(a===void 0)return{kind:"not_generated"};let o=t[a];if(o===void 0)return{kind:"invalid_generated",reason:"malformed_marker"};let s=o.match(ee);if(!s)return{kind:"invalid_generated",reason:"malformed_marker"};let[,n,r,d]=s;if(n===void 0||r===void 0||d===void 0)return{kind:"invalid_generated",reason:"malformed_marker"};let l=[...t.slice(0,a),...t.slice(a+1)].join(`
+`);if(h(l)!==d)return{kind:"invalid_generated",reason:"hash_mismatch"};return{kind:"valid_generated",marker:{name:n,version:r,hash:d}}}var H="opencode-plugin-flow",Q="file=",C="=sha256:";function b(e){let t=new Map;for(let i of e.split(`
+`)){if(!i.startsWith(Q))continue;let a=i.slice(Q.length),o=a.lastIndexOf(C);if(o===-1)continue;let s=a.slice(0,o),n=a.slice(o+C.length);if(s.length>0&&/^[a-f0-9]{64}$/.test(n))t.set(s,n)}return t}function k(e,t,i){let a=new Map;for(let n of e.split(`
+`)){let r=n.indexOf("=");if(r===-1)continue;a.set(n.slice(0,r),n.slice(r+1))}let o=a.get("version"),s=a.get("hash");if(a.get("plugin")!==H||a.get("kind")!==t||a.get("name")!==i||!o||!s?.startsWith("sha256:"))return null;return{kind:t,name:i,version:o,hash:s.slice(7)}}function j(e){let t=new Map;for(let s of e.split(`
+`)){let n=s.indexOf("=");if(n===-1)continue;t.set(s.slice(0,n),s.slice(n+1))}let i=t.get("plugin"),a=t.get("version");if(i!==H||!a)return null;let o=t.get("hash");return{plugin:i,version:a,hash:o?.startsWith("sha256:")?o.slice(7):null}}import{mkdir as At,rm as F,writeFile as Tt}from"node:fs/promises";import{join as J,sep as St}from"node:path";import{readFile as ae}from"node:fs/promises";async function w(e){try{return await ae(e,"utf8")}catch(t){if(t.code==="ENOENT")return null;throw t}}function Z(e){return`${["---",`description: ${JSON.stringify(e.description)}`,...e.agent?[`agent: ${JSON.stringify(e.agent)}`]:[],...e.subtask===void 0?[]:[`subtask: ${e.subtask}`],"---"].join(`
 `)}
 
 ${e.template}
-`}function ee(e){return`${["---",`description: ${JSON.stringify(e.description)}`,`mode: ${e.mode}`,...e.reasoningEffort?[`reasoningEffort: ${e.reasoningEffort}`]:[],...e.permission?te(e.permission):[],"---"].join(`
+`}function $(e){return`${["---",`description: ${JSON.stringify(e.description)}`,`mode: ${e.mode}`,...e.reasoningEffort?[`reasoningEffort: ${e.reasoningEffort}`]:[],...e.permission?ie(e.permission):[],"---"].join(`
 `)}
 
 ${e.prompt}
-`}function U(){return new Map(Object.entries(W).map(([e,t])=>[e,D(t)]))}function G(){return new Map(Object.entries(j).map(([e,t])=>[e,ee(t)]))}async function P(e){let t=[],i=[];for(let a of e.names){let s=C(e.root,`${a}.md`),o=C(e.root,`.${a}.flow-version`),n=await V(o),r=n===null?null:b(n,e.kind,a);if(r===null)continue;let d=await V(s);if(d!==null&&f(d)!==r.hash){i.push(s);continue}if(!e.dryRun)await F(s,{force:!0}),await F(o,{force:!0}),await F(`${s}.backup`,{force:!0});t.push(s)}return{removed:t,keptUserEdited:i}}async function V(e){try{return await K(e,"utf8")}catch(t){if(t.code==="ENOENT")return null;throw t}}function te(e){if(!e)return[];let t=["permission:"];for(let[i,a]of Object.entries(e)){if(typeof a==="string"){t.push(`  ${JSON.stringify(i)}: ${JSON.stringify(a)}`);continue}if(a&&typeof a==="object"){t.push(`  ${JSON.stringify(i)}:`);for(let[s,o]of Object.entries(a))t.push(`    ${JSON.stringify(s)}: ${JSON.stringify(o)}`)}}return t}async function L({homeDir:e,dryRun:t=!1,logger:i}){let a={removedSkills:[],keptUserEditedSkills:[],removedCommands:[],keptUserEditedCommands:[],removedAgents:[],keptUserEditedAgents:[],removedPreNpmPlugin:null,keptForeignPreNpmPlugin:null},s=l(e,x);for(let d of await ce(s)){if(d!=="flow"&&!d.startsWith("flow-"))continue;let c=l(s,d),u=await de(c);if(u==="foreign")continue;if(u==="user_edited"){a.keptUserEditedSkills.push(c),i?.(`Kept user-edited Flow skill at ${c}; remove it manually if it is no longer needed.`);continue}if(!t)await le(c);a.removedSkills.push(c),i?.(`${t?"Would remove":"Removed"} Flow skill at ${c}.`)}let o=await P({kind:"command",root:l(e,g),names:k,dryRun:t});for(let d of o.removed)a.removedCommands.push(d),i?.(`${t?"Would remove":"Removed"} retired Flow command at ${d}.`);for(let d of o.keptUserEdited)a.keptUserEditedCommands.push(d),i?.(`Kept user-edited Flow command at ${d}; remove it manually if it is no longer needed.`);await Q({homeDir:e,dryRun:t,logger:i,kind:"command",root:l(e,g),files:U(),removed:a.removedCommands,keptUserEdited:a.keptUserEditedCommands}),await Q({homeDir:e,dryRun:t,logger:i,kind:"agent",root:l(e,_),files:G(),removed:a.removedAgents,keptUserEdited:a.keptUserEditedAgents});let n=l(e,R),r=await p(n);if(r!==null)if(r.startsWith(A)){if(!t)await h(n,{force:!0});a.removedPreNpmPlugin=n,i?.(`${t?"Would remove":"Removed"} pre-npm Flow plugin copy at ${n}.`)}else a.keptForeignPreNpmPlugin=n,i?.(`Kept ${n}: it is not managed by Flow. Remove it manually if it is a stale Flow copy.`);return i?.('Finally, remove "opencode-plugin-flow" from the plugin array in opencode.json and restart OpenCode.'),a}async function de(e){let t=l(e,"SKILL.md"),i=await p(t),a=await p(l(e,v)),s=a===null?null:T(a);if(s!==null&&a!==null){for(let[r,d]of y(a)){if(r==="SKILL.md")continue;let c=H(e,r);if(c===null)continue;let u=await p(c);if(u!==null&&f(u)!==d)return"user_edited"}if(i===null)return"pristine";if(s.hash!==null&&f(i)===s.hash)return"pristine";return m(i).kind==="valid_generated"?"pristine":"user_edited"}if(i===null)return"foreign";let o=m(i);if(o.kind==="valid_generated")return"pristine";if(o.kind==="invalid_generated")return"user_edited";return"foreign"}function H(e,t){let i=ne(l(e,...t.split("/")));if(i!==e&&i.startsWith(`${e}${re}`))return i;return null}async function le(e){let t=await p(l(e,v)),i=new Set;if(t!==null)for(let a of y(t).keys()){let s=H(e,a);if(s===null)continue;await h(s,{force:!0}),await h(`${s}.backup`,{force:!0});let o=oe(s);if(o!==e)i.add(o)}await h(l(e,"SKILL.md"),{force:!0}),await h(l(e,v),{force:!0}),await h(l(e,E),{force:!0});for(let a of[...i].sort((s,o)=>o.length-s.length))await I(a);await I(e)}async function I(e){try{await se(e)}catch(t){let i=t.code;if(i!=="ENOENT"&&i!=="ENOTEMPTY")throw t}}async function ce(e){try{return(await ae(e,{withFileTypes:!0})).filter((i)=>i.isDirectory()).map((i)=>i.name).sort()}catch(t){if(t.code==="ENOENT")return[];throw t}}async function p(e){try{return await ie(e,"utf8")}catch(t){if(t.code==="ENOENT")return null;throw t}}async function Q(e){for(let[t,i]of e.files){let a=l(e.root,`${t}.md`),s=l(e.root,`.${t}.flow-version`),o=await p(a),n=await p(s),r=n===null?null:b(n,e.kind,t);if(o===null&&r===null)continue;if(!(r!==null||o===i))continue;if(o!==null&&r!==null&&f(o)!==r.hash){e.keptUserEdited.push(a),e.logger?.(`Kept user-edited Flow ${e.kind} at ${a}; remove it manually if it is no longer needed.`);continue}if(!e.dryRun)await h(a,{force:!0}),await h(s,{force:!0}),await h(`${a}.backup`,{force:!0});e.removed.push(a),e.logger?.(`${e.dryRun?"Would remove":"Removed"} Flow ${e.kind} at ${a}.`)}if(!e.dryRun)await I(e.root)}var q=`opencode-plugin-flow — Flow plugin lifecycle commands
+`}function x(){return new Map(Object.entries(G).map(([e,t])=>[e,Z(t)]))}function _(){return new Map(Object.entries(V).map(([e,t])=>[e,$(t)]))}async function W(e){let t=[],i=[];for(let a of e.names){let o=J(e.root,`${a}.md`),s=J(e.root,`.${a}.flow-version`),n=await w(s),r=n===null?null:k(n,e.kind,a);if(r===null)continue;let d=await w(o);if(d!==null&&h(d)!==r.hash){i.push(o);continue}if(!e.dryRun)await F(o,{force:!0}),await F(s,{force:!0}),await F(`${o}.backup`,{force:!0});t.push(o)}return{removed:t,keptUserEdited:i}}function ie(e){if(!e)return[];let t=["permission:"];for(let[i,a]of Object.entries(e)){if(typeof a==="string"){t.push(`  ${JSON.stringify(i)}: ${JSON.stringify(a)}`);continue}if(a&&typeof a==="object"){t.push(`  ${JSON.stringify(i)}:`);for(let[o,s]of Object.entries(a))t.push(`    ${JSON.stringify(o)}: ${JSON.stringify(s)}`)}}return t}async function P({homeDir:e,dryRun:t=!1,logger:i}){let a={removedSkills:[],keptUserEditedSkills:[],removedCommands:[],keptUserEditedCommands:[],removedAgents:[],keptUserEditedAgents:[],removedPreNpmPlugin:null,keptForeignPreNpmPlugin:null},o=c(e,A);for(let d of await we(o)){if(d!=="flow"&&!d.startsWith("flow-"))continue;let l=c(o,d),p=await fe(l);if(p==="foreign")continue;if(p==="user_edited"){a.keptUserEditedSkills.push(l),i?.(`Kept user-edited Flow skill at ${l}; remove it manually if it is no longer needed.`);continue}if(!t)await ve(l);a.removedSkills.push(l),i?.(`${t?"Would remove":"Removed"} Flow skill at ${l}.`)}let s=await W({kind:"command",root:c(e,m),names:R,dryRun:t});for(let d of s.removed)a.removedCommands.push(d),i?.(`${t?"Would remove":"Removed"} retired Flow command at ${d}.`);for(let d of s.keptUserEdited)a.keptUserEditedCommands.push(d),i?.(`Kept user-edited Flow command at ${d}; remove it manually if it is no longer needed.`);await O({homeDir:e,dryRun:t,logger:i,kind:"command",root:c(e,m),files:x(),removed:a.removedCommands,keptUserEdited:a.keptUserEditedCommands}),await O({homeDir:e,dryRun:t,logger:i,kind:"agent",root:c(e,T),files:_(),removed:a.removedAgents,keptUserEdited:a.keptUserEditedAgents});let n=c(e,q),r=await f(n);if(r!==null)if(r.startsWith(S)){if(!t)await u(n,{force:!0});a.removedPreNpmPlugin=n,i?.(`${t?"Would remove":"Removed"} pre-npm Flow plugin copy at ${n}.`)}else a.keptForeignPreNpmPlugin=n,i?.(`Kept ${n}: it is not managed by Flow. Remove it manually if it is a stale Flow copy.`);return i?.('Finally, remove "opencode-plugin-flow" from the plugin array in opencode.json and restart OpenCode.'),a}async function fe(e){let t=c(e,"SKILL.md"),i=await f(t),a=await f(c(e,v)),o=a===null?null:j(a);if(o!==null&&a!==null){for(let[r,d]of b(a)){if(r==="SKILL.md")continue;let l=N(e,r);if(l===null)continue;let p=await f(l);if(p!==null&&h(p)!==d)return"user_edited"}if(i===null)return"pristine";if(o.hash!==null&&h(i)===o.hash)return"pristine";return y(i).kind==="valid_generated"?"pristine":"user_edited"}if(i===null)return"foreign";let s=y(i);if(s.kind==="valid_generated")return"pristine";if(s.kind==="invalid_generated")return"user_edited";return"foreign"}function N(e,t){let i=he(c(e,...t.split("/")));if(i!==e&&i.startsWith(`${e}${pe}`))return i;return null}async function ve(e){let t=await f(c(e,v)),i=new Set;if(t!==null)for(let a of b(t).keys()){let o=N(e,a);if(o===null)continue;await u(o,{force:!0}),await u(`${o}.backup`,{force:!0});let s=ue(o);if(s!==e)i.add(s)}await u(c(e,"SKILL.md"),{force:!0}),await u(c(e,v),{force:!0}),await u(c(e,Y),{force:!0});for(let a of[...i].sort((o,s)=>s.length-o.length))await B(a);await B(e)}async function B(e){try{await le(e)}catch(t){let i=t.code;if(i!=="ENOENT"&&i!=="ENOTEMPTY")throw t}}async function we(e){try{return(await de(e,{withFileTypes:!0})).filter((i)=>i.isDirectory()).map((i)=>i.name).sort()}catch(t){if(t.code==="ENOENT")return[];throw t}}async function f(e){try{return await ce(e,"utf8")}catch(t){if(t.code==="ENOENT")return null;throw t}}async function O(e){for(let[t,i]of e.files){let a=c(e.root,`${t}.md`),o=c(e.root,`.${t}.flow-version`),s=await f(a),n=await f(o),r=n===null?null:k(n,e.kind,t);if(s===null&&r===null)continue;if(!(r!==null||s===i))continue;if(s!==null&&r!==null&&h(s)!==r.hash){e.keptUserEdited.push(a),e.logger?.(`Kept user-edited Flow ${e.kind} at ${a}; remove it manually if it is no longer needed.`);continue}if(!e.dryRun)await u(a,{force:!0}),await u(o,{force:!0}),await u(`${a}.backup`,{force:!0});e.removed.push(a),e.logger?.(`${e.dryRun?"Would remove":"Removed"} Flow ${e.kind} at ${a}.`)}if(!e.dryRun)await B(e.root)}var I=`opencode-plugin-flow — Flow plugin lifecycle commands
 
 Usage:
   bunx opencode-plugin-flow uninstall [--dry-run]
@@ -26,10 +26,10 @@ Commands:
 
 Options:
   --dry-run   Show what would be removed without deleting anything
-  --help      Show this message`;function Y(e){process.stdout.write(`${e}
-`)}function S(e){process.stderr.write(`${e}
-`)}async function ue(e){let t=[...e];if(t.length===0||t.includes("--help")||t.includes("-h"))return Y(q),0;let i=t.shift();if(i!=="uninstall")return S(`Unknown command: ${i}
+  --help      Show this message`;function K(e){process.stdout.write(`${e}
+`)}function z(e){process.stderr.write(`${e}
+`)}async function me(e){let t=[...e];if(t.length===0||t.includes("--help")||t.includes("-h"))return K(I),0;let i=t.shift();if(i!=="uninstall")return z(`Unknown command: ${i}
 
-${q}`),1;let a=!1;for(let s of t){if(s==="--dry-run"){a=!0;continue}return S(`Unknown argument: ${s}
+${I}`),1;let a=!1;for(let o of t){if(o==="--dry-run"){a=!0;continue}return z(`Unknown argument: ${o}
 
-${q}`),1}return await L({homeDir:process.env.HOME??he(),dryRun:a,logger:Y}),0}try{process.exitCode=await ue(process.argv.slice(2))}catch(e){S(e instanceof Error?e.message:String(e)),process.exitCode=1}
+${I}`),1}return await P({homeDir:process.env.HOME??ge(),dryRun:a,logger:K}),0}try{process.exitCode=await me(process.argv.slice(2))}catch(e){z(e instanceof Error?e.message:String(e)),process.exitCode=1}