Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

fix(plugins): allow native freeform inputs and version Codex hook repair

Stuart Kerr24a83b3297e5
diff --git a/plugins/ruflo-adr/.codex-plugin/plugin.json b/plugins/ruflo-adr/.codex-plugin/plugin.json
index ca9da01fb7..73438d0e23 100644
--- a/plugins/ruflo-adr/.codex-plugin/plugin.json
+++ b/plugins/ruflo-adr/.codex-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "ruflo-adr",
"description": "ADR lifecycle management \u2014 create, index, reconcile, supersede, check compliance, and link Architecture Decision Records to code via AgentDB hierarchical store + causal edges (supersedes/amends/depends-on/related)",
- "version": "0.5.3",
+ "version": "0.5.4",
"author": {
"name": "ruvnet",
"url": "https://github.com/ruvnet"
diff --git a/plugins/ruflo-adr/README.md b/plugins/ruflo-adr/README.md
index 1adb9f7f90..48aac9e8de 100644
--- a/plugins/ruflo-adr/README.md
+++ b/plugins/ruflo-adr/README.md
@@ -133,3 +133,11 @@ The adapters need Node.js and contain no runtime SDK dependency.
This source change requires a released upstream package or an explicitly owned
source projection to reach installations. It does not patch foreign cache entries,
pin upstream updates, disable plugins, or claim an already published repair.
+
+Release both host manifests with the same patch version. Codex 0.160's published
+remote-bundle sync skips downloading a release whose version equals the installed
+version; merging same-version source does not establish automatic cache refresh.
+Its explicit native plugin install replaces the cached root atomically even at the
+same version. An owned projection must therefore refresh its upstream source
+generation and explicitly reinstall it; refreshing a marketplace catalog alone
+is not installation proof. No foreign cache entry should be edited in place.
diff --git a/plugins/ruflo-adr/hooks/codex-hook.cjs b/plugins/ruflo-adr/hooks/codex-hook.cjs
index b361a02a26..a7bddaf630 100644
--- a/plugins/ruflo-adr/hooks/codex-hook.cjs
+++ b/plugins/ruflo-adr/hooks/codex-hook.cjs
@@ -3,9 +3,9 @@
`);try{const courtesy=import_node_path.default.join(directory(import_node_path.default.join(event.cwd,import_node_path.default.dirname(plugin.statusPath))),import_node_path.default.basename(plugin.statusPath));const view=JSON.parse(plugin.statusText(stats,now));write(courtesy,`${JSON.stringify({...view,host:"codex",sessionId:event.session_id},null,2)}
`)}catch{}return stats}finally{import_node_fs.default.rmdirSync(lock)}}function validEvent(event){return plain(event)&&typeof event.cwd==="string"&&import_node_path.default.isAbsolute(event.cwd)&&typeof event.session_id==="string"&&event.session_id.length>0&&event.session_id.length<=512}async function runCodexHook(plugin){const mode=process.argv[2];if(mode==="--command"){const cwd=process.cwd();const view=snapshot(import_node_path.default.join(cwd,plugin.statusPath));const text=await plugin.answer(process.argv.slice(3).join(" "),{opts:{guard:true},guard:true,stats:view?.host==="codex"?view:plugin.newStats(),tools:async()=>[],list:async relative=>import_node_fs.default.readdirSync(import_node_path.default.join(cwd,relative),{withFileTypes:true}).map(entry=>({name:entry.name,kind:entry.isDirectory()?"dir":"file"}))});process.stdout.write(`${text}
`);return}const chunks=[];let bytes=0;for await(const chunk of process.stdin){bytes+=chunk.length;if(bytes>MAX_INPUT)throw new Error("Hook input exceeds bound");chunks.push(chunk)}const event=JSON.parse(Buffer.concat(chunks).toString("utf8"));if(!validEvent(event)||event.hook_event_name!==mode)throw new Error("Invalid hook envelope");if(mode==="SessionStart"){try{updateStatus(plugin,event,stats=>{if("startedMs"in stats&&!stats.startedMs)stats.startedMs=Date.now()})}catch{process.stderr.write(`${plugin.name}: courtesy status unavailable
-`)}return}if(mode!=="PreToolUse"||typeof event.tool_name!=="string"||!plain(event.tool_input))throw new Error("Invalid native tool event");const reason=plugin.verdict(event.tool_name,event.tool_input);try{updateStatus(plugin,event,stats=>plugin.count(stats,event.tool_name,event.tool_input,reason))}catch{process.stderr.write(`${plugin.name}: courtesy status unavailable
+`)}return}if(mode!=="PreToolUse"||typeof event.tool_name!=="string"||!Object.hasOwn(event,"tool_input"))throw new Error("Invalid native tool event");const shortName=event.tool_name.startsWith("mcp__")?event.tool_name.slice(event.tool_name.lastIndexOf("__")+2):event.tool_name;if(plugin.writers.includes(shortName)&&!plain(event.tool_input))throw new Error("Invalid guarded writer input");const reason=plugin.verdict(event.tool_name,event.tool_input);try{updateStatus(plugin,event,stats=>plugin.count(stats,event.tool_name,event.tool_input,reason))}catch{process.stderr.write(`${plugin.name}: courtesy status unavailable
`)}if(reason!==void 0)process.stdout.write(`${JSON.stringify({hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:reason}})}
`)}function hookFailure(plugin){process.stderr.write(`${plugin}: native hook input or adapter failed
`);process.exitCode=2}var newStats=()=>({calls:0,blocked:0,startedMs:0});var STATUS_PATH=".claude-flow/adr-mod/status.json";function statusText(stats,mode,nowMs){return`${JSON.stringify({version:1,updatedMs:nowMs,mod:"adr",guard:mode.guard,...stats},null,2)}
`}var COMMON_SECRETS=[["private key",/-----BEGIN [A-Z ]*PRIVATE KEY-----/],["aws access key",/\b(?:AKIA|ASIA)[0-9A-Z]{16}\b/],["github token",/\b(?:gh[pousr]_[A-Za-z0-9]{30,}|github_pat_[A-Za-z0-9_]{40,})\b/],["slack token",/\bxox[abprs]-[A-Za-z0-9-]{10,}/],["slack webhook",/\bhooks\.slack\.com\/services\/T[A-Z0-9]{6,}\/B[A-Z0-9]{6,}\/[A-Za-z0-9]{16,}/],["google api key",/\bAIza[0-9A-Za-z_-]{35}\b/],["anthropic or openai key",/\bsk-(?:(?:ant|proj|svcacct|admin)-[A-Za-z0-9_-]{20,}|(?=[A-Za-z]{0,40}\d)[A-Za-z0-9]{32,})/],["stripe key",/\b[rs]k_live_[A-Za-z0-9]{16,}/],["npm token",/\bnpm_[A-Za-z0-9]{36}\b/],["huggingface token",/\bhf_[A-Za-z0-9]{30,}\b/],["sendgrid key",/\bSG\.[A-Za-z0-9_-]{16,}\.[A-Za-z0-9_-]{16,}/],["twilio key",/\bSK[0-9a-f]{32}\b/],["jwt",/\beyJ[A-Za-z0-9_-]{8,}\.eyJ[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}/],["bearer token",/\bBearer\s+([A-Za-z0-9._~+/=-]{24,})/],["database url with credentials",/\b[a-z][a-z0-9+.-]{1,20}:\/\/[^\s:@/]+:[^\s@/]{3,}@[^\s/]+/i]];var INJECTION=[["override instructions",/\b(?:ignore|disregard|forget|override)\b[^.\n]{0,40}\b(?:previous|prior|above|earlier|all|any|system)\b[^.\n]{0,30}\b(?:instructions?|rules?|prompts?|guidelines?)\b/i],["role reassignment",/\byou are (?:now|no longer)\b|\bact as (?:an? )?(?:unrestricted|jailbroken)\b/i],["new instructions",/\b(?:new|updated|real) (?:system )?instructions?\s*:/i],["fake role tags",/<\/?\s*(?:system|assistant|developer|instructions?)\s*>|^\s*(?:system|assistant)\s*:/im],["concealment",/\bdo not (?:tell|inform|mention|reveal)[^.\n]{0,30}\b(?:user|human|operator)\b/i],["exfiltration",/\b(?:exfiltrate|send|post|upload)\b[^.\n]{0,50}\b(?:secrets?|credentials?|tokens?|api keys?|\.env)\b/i],["shell pipe",/\b(?:curl|wget)\b[^|\n]{0,200}\|\s*(?:sudo\s+)?(?:ba|z)?sh\b/i]];var INVISIBLE=new RegExp("[\\u0000-\\u0008\\u000b-\\u001f\\u007f-\\u009f\\u00ad\\u034f\\u061c\\u115f\\u1160\\u17b4\\u17b5\\u180b-\\u180e\\u200b-\\u200f\\u2028-\\u202e\\u2060-\\u206f\\u3164\\ufe00-\\ufe0f\\ufeff\\uffa0\\ufff9-\\ufffb]","g");var MAX_SCAN=2e5;var bare=text=>(text.length>MAX_SCAN?text.slice(0,MAX_SCAN/2)+"\n"+text.slice(-MAX_SCAN/2):text).replace(INVISIBLE,"");var PLACEHOLDER=/placeholder|your[-_ ]|example|changeme|change[-_]?me|redacted|dummy|replace[-_]?me|insert[-_]|\*{3,}|x{5,}|\.{3}|^(?:none|null|undefined|true|false)$/i;var REFERENCE=/^(?:\$(?:\{[^}]*\}|\(|[A-Za-z_]\w*$)|%[^%]*%$|<[^>]*>$|\{\{|process\.env|os\.environ|env[.[]|import\.meta|System\.getenv|secrets?\.|vault:|op:\/\/|ref\+|arn:|projects\/[^/]+\/secrets\/|gcp:|kms:|aws:|file:)/i;var CALL=/^[A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)*\(|^[A-Za-z_$][\w$]*\[/;var IDENT_PATH=/^[A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)+$/;var UUID=/^[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$/i;var NAME_LIKE=/^[a-z][a-z0-9]*(?:[-_./][a-z0-9]+){2,}$/;function entropy(v){const counts=new Map;for(const ch of v)counts.set(ch,(counts.get(ch)??0)+1);let h=0;for(const n of counts.values())h-=n/v.length*Math.log2(n/v.length);return h}function isReference(v){if(PLACEHOLDER.test(v)||REFERENCE.test(v)||CALL.test(v)||IDENT_PATH.test(v)||URL_NO_CREDS.test(v))return true;return NAME_LIKE.test(v)&&v.replace(/\D/g,"").length/v.length<.15}function plausibleSecret(v){if(v.length<8||v.length>256||/\s/.test(v)||UUID.test(v)||isReference(v))return false;const symbol=/[^A-Za-z0-9]/.test(v);const digit=/\d/.test(v);const classes=[/[a-z]/.test(v),/[A-Z]/.test(v),digit,symbol].filter(Boolean).length;return classes>=2&&(digit||symbol)&&entropy(v)>=2.5}var KEYED_MIN=20;var PLACEHOLDER_WORD=/(?:^|[^a-z])(?:your|placeholder|changeme|change[-_]?me|example|redacted|dummy|replace[-_]?me|insert)(?:[^a-z]|$)|\*{3,}|x{5,}|\.{3}|^(?:none|null|undefined|true|false)$/i;var URL_NO_CREDS=/^[a-z][a-z0-9+.-]{1,20}:\/\/[^\s@]*$/i;function hyphenName(v){const parts=v.split("-");return parts.length>=3&&parts.every(p=>/^[a-z0-9]{2,}$/.test(p)&&!/^[0-9a-f]{8,}$/.test(p))&&v.replace(/\D/g,"").length/v.length<.15}function keyedSecret(v){if(v.length<KEYED_MIN||v.length>256||/\s/.test(v))return false;return!(PLACEHOLDER_WORD.test(v)||REFERENCE.test(v)||CALL.test(v)||IDENT_PATH.test(v)||URL_NO_CREDS.test(v)||!UUID.test(v)&&hyphenName(v))}var KEY_NAME=/(?:api[_-]?key|secret|token|passw(?:or)?d|passwd|pwd|credential|private[_-]?key|auth(?!or))s?[A-Za-z0-9_-]{0,40}["']?\s*[:=]\s*/gi;var QUOTED=/(["'\x60])((?:(?!\1)[^\n]){1,256})\1/y;var BARE_VALUE=/[^\s"'\x60,;]{1,256}/y;var QUERY_VALUE=/[^\s"'\x60,;&]{1,256}/y;function assignmentSecret(text){let valueEnd=0;for(const m of text.matchAll(KEY_NAME)){if(m.index<valueEnd)continue;const at=m.index+m[0].length;let back=m.index;while(back>0&&m.index-back<64&&/[A-Za-z0-9_.-]/.test(text.charAt(back-1)))back--;const re=/["'\x60]/.test(text.charAt(at))?QUOTED:/[?&]/.test(text.charAt(back-1))?QUERY_VALUE:BARE_VALUE;re.lastIndex=at;const hit=re.exec(text);const v=hit&&(hit[2]??hit[0]);valueEnd=hit?at+hit[0].length:at;if(v&&(plausibleSecret(v)||keyedSecret(v)))return true}return false}function urlCredential(url){const pass=/^[^:]+:\/\/[^\s:@/]+:([^\s@/]+)@/.exec(url)?.[1];if(!pass||/\$\{|\{\{|%\(|%s/.test(pass))return false;return!/^(?:password|passwd|pass|pwd|secret|changeme|dbpassword|db_password|\$\w*|<.*>|\{.*\}|\*+|x+)$/i.test(pass)&&!PLACEHOLDER.test(pass)}var CHECKS={"bearer token":m=>!isReference(m[1]??""),"database url with credentials":m=>urlCredential(m[0]),"database url with password":m=>urlCredential(m[0])};var globals=new WeakMap;function matches(name,re,text){if(name==="key assignment")return assignmentSecret(text);const check=CHECKS[name];if(!check)return re.test(text);let g=globals.get(re);if(!g)globals.set(re,g=new RegExp(re.source,re.flags.includes("g")?re.flags:re.flags+"g"));for(const m of text.matchAll(g))if(check(m))return true;return false}var TRUNCATED="ruflo-screen: input exceeded the screening budget";var TRUNCATED_NAME="input too large to screen";var names=(rules,text)=>text===TRUNCATED?[TRUNCATED_NAME]:rules.filter(([name,re])=>matches(name,re,text)).map(([name])=>name);function screenWith(secrets,text){const bounded=bare(text);return{secrets:names(secrets,bounded),injection:names(INJECTION,bounded)}}var hasSecretIn=(secrets,text)=>names(secrets,bare(text)).length>0;var NODES=2e4;var CHARS=2e6;var PER_STRING=15e5;var OVERLAP=2048;var BARE_KEY_MIN=8;function windows(text,out){if(text.length<=MAX_SCAN){out.push(text);return}for(let at=0;;at+=MAX_SCAN-OVERLAP){out.push(text.slice(at,at+MAX_SCAN));if(at+MAX_SCAN>=text.length)return}}function textsOf(input,limits={}){const out=[];let slots=limits.nodes??NODES;let chars=limits.chars??CHARS;const perString=limits.perString??PER_STRING;let truncated=false;const take=text=>{if(chars<=0){truncated=true;return}if(text.length<=Math.min(perString,chars)){chars-=text.length;windows(text,out);return}truncated=true;const half=Math.floor(Math.min(perString,chars)/2);chars-=2*half;windows(text.slice(0,half),out);windows(text.slice(-half),out)};const queue=[input];let head=0;for(;head<queue.length&&chars>0;head++){const node=queue[head];if(typeof node==="string")take(node);else if(Array.isArray(node)){let i=0;for(;i<node.length&&slots>0;i++,slots--)if(i in node)queue.push(node[i]);if(i<node.length)truncated=true}else if(typeof node==="object"&&node!==null){for(const k in node){if(slots--<=0){truncated=true;break}if(!Object.prototype.hasOwnProperty.call(node,k))continue;const v=node[k];if(typeof v==="string")queue.push(k+"="+v);else{if(k.length>=BARE_KEY_MIN)take(k);queue.push(v)}}}}if(queue.length>head)truncated=true;if(truncated)out.push(TRUNCATED);return out}var SECRETS=[...COMMON_SECRETS,["key assignment",/\b(?:api[_-]?key|secret|token|passw(?:or)?d|credential)s?["']?\s*[:=]\s*["']?[A-Za-z0-9/+=_.-]{16,}/i]];var scan=text=>screenWith(SECRETS,text);var hasSecret=text=>hasSecretIn(SECRETS,text);var HELP=["/adr-mod status","/adr-mod scan <text>","/adr-mod format"].join("\n");function answer(args,deps){const[verb="",...rest]=args.trim().split(/\s+/);const arg=rest.join(" ");const{opts,stats}=deps;if(verb===""||verb==="help")return HELP;if(verb==="status"){return`guard ${opts.guard?"on":"off"} \xB7 calls guarded ${stats.calls} \xB7 blocked ${stats.blocked}`}if(verb==="scan"){if(arg==="")return"usage: /adr-mod scan <text>";const found=scan(arg);const parts=[found.secrets.length?`secrets: ${found.secrets.join(", ")}`:"",found.injection.length?`injection phrasing: ${found.injection.join(", ")}`:""].filter(Boolean);return parts.length?`The guard would refuse a write of that (${parts.join("; ")}).`:"Nothing found: the guard would let that through."}if(verb==="format")return"An ADR carries: Status (proposed, accepted, deprecated, superseded), Context, Decision, Consequences. Relations: supersedes, amends, depends-on, related. Create with /adr-create, index with /adr-index.";return`Unknown: ${verb}
-${HELP}`}function splitName(name){if(!name.startsWith("mcp__"))return void 0;const at=name.lastIndexOf("__");return at>5?{server:name.slice(5,at),tool:name.slice(at+2)}:void 0}var namespaceOf=input=>{const ns=input?.namespace;return typeof ns==="string"?ns:""};var ADR_ID=/^(?:mem:)?ADR-/i;var field=(input,key)=>{const v=input?.[key];return typeof v==="string"?v:""};function owns(tool,input){const parts=splitName(tool);const name=parts?.tool??tool;const adrNamespace=/adr/i.test(namespaceOf(input));if(name==="memory_store")return adrNamespace;if(name==="agentdb_hierarchical-store")return adrNamespace||ADR_ID.test(field(input,"key"));if(name==="agentdb_causal-edge")return adrNamespace||ADR_ID.test(field(input,"sourceId"))||ADR_ID.test(field(input,"targetId"));return false}function verdict(tool,input){if(!owns(tool,input))return void 0;return textsOf(input).some(hasSecret)?"ruflo-adr: this ADR write holds what looks like a secret (a key, token or password). An ADR records a decision; name where the secret lives, not its value.":void 0}runCodexHook({name:"ruflo-adr",verdict,newStats,statusPath:STATUS_PATH,answer,statusText:(stats,now)=>statusText(stats,{guard:true},now),count:(stats,tool,input,reason)=>{if(owns(tool,input)){stats.calls++;if(reason!==void 0)stats.blocked++}}}).catch(()=>hookFailure("ruflo-adr"));
+${HELP}`}function splitName(name){if(!name.startsWith("mcp__"))return void 0;const at=name.lastIndexOf("__");return at>5?{server:name.slice(5,at),tool:name.slice(at+2)}:void 0}var namespaceOf=input=>{const ns=input?.namespace;return typeof ns==="string"?ns:""};var ADR_ID=/^(?:mem:)?ADR-/i;var field=(input,key)=>{const v=input?.[key];return typeof v==="string"?v:""};function owns(tool,input){const parts=splitName(tool);const name=parts?.tool??tool;const adrNamespace=/adr/i.test(namespaceOf(input));if(name==="memory_store")return adrNamespace;if(name==="agentdb_hierarchical-store")return adrNamespace||ADR_ID.test(field(input,"key"));if(name==="agentdb_causal-edge")return adrNamespace||ADR_ID.test(field(input,"sourceId"))||ADR_ID.test(field(input,"targetId"));return false}function verdict(tool,input){if(!owns(tool,input))return void 0;return textsOf(input).some(hasSecret)?"ruflo-adr: this ADR write holds what looks like a secret (a key, token or password). An ADR records a decision; name where the secret lives, not its value.":void 0}runCodexHook({name:"ruflo-adr",writers:["memory_store","agentdb_hierarchical-store","agentdb_causal-edge"],verdict,newStats,statusPath:STATUS_PATH,answer,statusText:(stats,now)=>statusText(stats,{guard:true},now),count:(stats,tool,input,reason)=>{if(owns(tool,input)){stats.calls++;if(reason!==void 0)stats.blocked++}}}).catch(()=>hookFailure("ruflo-adr"));
diff --git a/plugins/ruflo-adr/hooks/codex.ts b/plugins/ruflo-adr/hooks/codex.ts
index 1a3f4ae4a4..2c02774c5c 100644
--- a/plugins/ruflo-adr/hooks/codex.ts
+++ b/plugins/ruflo-adr/hooks/codex.ts
@@ -3,7 +3,7 @@ import { newStats, STATUS_PATH, statusText } from './status'
import { answer } from './command'
import { verdict, owns } from './guard'
-runCodexHook({ name: 'ruflo-adr', verdict, newStats, statusPath: STATUS_PATH, answer,
+runCodexHook({ name: 'ruflo-adr', writers: ['memory_store', 'agentdb_hierarchical-store', 'agentdb_causal-edge'], verdict, newStats, statusPath: STATUS_PATH, answer,
statusText: (stats, now) => statusText(stats, { guard: true }, now),
count: (stats, tool, input, reason) => { if (owns(tool, input)) { stats.calls++; if (reason !== undefined) stats.blocked++; } },
}).catch(() => hookFailure('ruflo-adr'))
diff --git a/plugins/ruflo-ddd/.claude-plugin/plugin.json b/plugins/ruflo-ddd/.claude-plugin/plugin.json
index 595187e06b..e5cc11d88f 100644
--- a/plugins/ruflo-ddd/.claude-plugin/plugin.json
+++ b/plugins/ruflo-ddd/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "ruflo-ddd",
"description": "Domain-Driven Design scaffolding — bounded contexts, aggregate roots, domain events, value objects, repositories, and anti-corruption layers; navigable domain graph stored in AgentDB",
- "version": "0.3.3",
+ "version": "0.3.4",
"author": {
"name": "ruvnet",
"url": "https://github.com/ruvnet"
diff --git a/plugins/ruflo-ddd/.codex-plugin/plugin.json b/plugins/ruflo-ddd/.codex-plugin/plugin.json
index afe6a9aa0c..8bf8f5e83d 100644
--- a/plugins/ruflo-ddd/.codex-plugin/plugin.json
+++ b/plugins/ruflo-ddd/.codex-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "ruflo-ddd",
"description": "Domain-Driven Design scaffolding \u2014 bounded contexts, aggregate roots, domain events, value objects, repositories, and anti-corruption layers; navigable domain graph stored in AgentDB",
- "version": "0.3.3",
+ "version": "0.3.4",
"author": {
"name": "ruvnet",
"url": "https://github.com/ruvnet"
diff --git a/plugins/ruflo-ddd/README.md b/plugins/ruflo-ddd/README.md
index bb0adec0d5..bad18239a8 100644
--- a/plugins/ruflo-ddd/README.md
+++ b/plugins/ruflo-ddd/README.md
@@ -133,3 +133,11 @@ The adapters need Node.js and contain no runtime SDK dependency.
This source change requires a released upstream package or an explicitly owned
source projection to reach installations. It does not patch foreign cache entries,
pin upstream updates, disable plugins, or claim an already published repair.
+
+Release both host manifests with the same patch version. Codex 0.160's published
+remote-bundle sync skips downloading a release whose version equals the installed
+version; merging same-version source does not establish automatic cache refresh.
+Its explicit native plugin install replaces the cached root atomically even at the
+same version. An owned projection must therefore refresh its upstream source
+generation and explicitly reinstall it; refreshing a marketplace catalog alone
+is not installation proof. No foreign cache entry should be edited in place.
diff --git a/plugins/ruflo-ddd/hooks/codex-hook.cjs b/plugins/ruflo-ddd/hooks/codex-hook.cjs
index 73eaf29e5e..715ff141c7 100644
--- a/plugins/ruflo-ddd/hooks/codex-hook.cjs
+++ b/plugins/ruflo-ddd/hooks/codex-hook.cjs
@@ -3,10 +3,10 @@
`);try{const courtesy=import_node_path.default.join(directory(import_node_path.default.join(event.cwd,import_node_path.default.dirname(plugin.statusPath))),import_node_path.default.basename(plugin.statusPath));const view=JSON.parse(plugin.statusText(stats,now));write(courtesy,`${JSON.stringify({...view,host:"codex",sessionId:event.session_id},null,2)}
`)}catch{}return stats}finally{import_node_fs.default.rmdirSync(lock)}}function validEvent(event){return plain(event)&&typeof event.cwd==="string"&&import_node_path.default.isAbsolute(event.cwd)&&typeof event.session_id==="string"&&event.session_id.length>0&&event.session_id.length<=512}async function runCodexHook(plugin){const mode=process.argv[2];if(mode==="--command"){const cwd=process.cwd();const view=snapshot(import_node_path.default.join(cwd,plugin.statusPath));const text=await plugin.answer(process.argv.slice(3).join(" "),{opts:{guard:true},guard:true,stats:view?.host==="codex"?view:plugin.newStats(),tools:async()=>[],list:async relative=>import_node_fs.default.readdirSync(import_node_path.default.join(cwd,relative),{withFileTypes:true}).map(entry=>({name:entry.name,kind:entry.isDirectory()?"dir":"file"}))});process.stdout.write(`${text}
`);return}const chunks=[];let bytes=0;for await(const chunk of process.stdin){bytes+=chunk.length;if(bytes>MAX_INPUT)throw new Error("Hook input exceeds bound");chunks.push(chunk)}const event=JSON.parse(Buffer.concat(chunks).toString("utf8"));if(!validEvent(event)||event.hook_event_name!==mode)throw new Error("Invalid hook envelope");if(mode==="SessionStart"){try{updateStatus(plugin,event,stats=>{if("startedMs"in stats&&!stats.startedMs)stats.startedMs=Date.now()})}catch{process.stderr.write(`${plugin.name}: courtesy status unavailable
-`)}return}if(mode!=="PreToolUse"||typeof event.tool_name!=="string"||!plain(event.tool_input))throw new Error("Invalid native tool event");const reason=plugin.verdict(event.tool_name,event.tool_input);try{updateStatus(plugin,event,stats=>plugin.count(stats,event.tool_name,event.tool_input,reason))}catch{process.stderr.write(`${plugin.name}: courtesy status unavailable
+`)}return}if(mode!=="PreToolUse"||typeof event.tool_name!=="string"||!Object.hasOwn(event,"tool_input"))throw new Error("Invalid native tool event");const shortName=event.tool_name.startsWith("mcp__")?event.tool_name.slice(event.tool_name.lastIndexOf("__")+2):event.tool_name;if(plugin.writers.includes(shortName)&&!plain(event.tool_input))throw new Error("Invalid guarded writer input");const reason=plugin.verdict(event.tool_name,event.tool_input);try{updateStatus(plugin,event,stats=>plugin.count(stats,event.tool_name,event.tool_input,reason))}catch{process.stderr.write(`${plugin.name}: courtesy status unavailable
`)}if(reason!==void 0)process.stdout.write(`${JSON.stringify({hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:reason}})}
`)}function hookFailure(plugin){process.stderr.write(`${plugin}: native hook input or adapter failed
`);process.exitCode=2}var newStats=()=>({blocked:0});var STATUS_PATH=".claude-flow/ddd-mod/status.json";var statusText=(stats,guard,nowMs)=>`${JSON.stringify({version:1,updatedMs:nowMs,guard,...stats},null,2)}
`;var COMMON_SECRETS=[["private key",/-----BEGIN [A-Z ]*PRIVATE KEY-----/],["aws access key",/\b(?:AKIA|ASIA)[0-9A-Z]{16}\b/],["github token",/\b(?:gh[pousr]_[A-Za-z0-9]{30,}|github_pat_[A-Za-z0-9_]{40,})\b/],["slack token",/\bxox[abprs]-[A-Za-z0-9-]{10,}/],["slack webhook",/\bhooks\.slack\.com\/services\/T[A-Z0-9]{6,}\/B[A-Z0-9]{6,}\/[A-Za-z0-9]{16,}/],["google api key",/\bAIza[0-9A-Za-z_-]{35}\b/],["anthropic or openai key",/\bsk-(?:(?:ant|proj|svcacct|admin)-[A-Za-z0-9_-]{20,}|(?=[A-Za-z]{0,40}\d)[A-Za-z0-9]{32,})/],["stripe key",/\b[rs]k_live_[A-Za-z0-9]{16,}/],["npm token",/\bnpm_[A-Za-z0-9]{36}\b/],["huggingface token",/\bhf_[A-Za-z0-9]{30,}\b/],["sendgrid key",/\bSG\.[A-Za-z0-9_-]{16,}\.[A-Za-z0-9_-]{16,}/],["twilio key",/\bSK[0-9a-f]{32}\b/],["jwt",/\beyJ[A-Za-z0-9_-]{8,}\.eyJ[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}/],["bearer token",/\bBearer\s+([A-Za-z0-9._~+/=-]{24,})/],["database url with credentials",/\b[a-z][a-z0-9+.-]{1,20}:\/\/[^\s:@/]+:[^\s@/]{3,}@[^\s/]+/i]];var INVISIBLE=new RegExp("[\\u0000-\\u0008\\u000b-\\u001f\\u007f-\\u009f\\u00ad\\u034f\\u061c\\u115f\\u1160\\u17b4\\u17b5\\u180b-\\u180e\\u200b-\\u200f\\u2028-\\u202e\\u2060-\\u206f\\u3164\\ufe00-\\ufe0f\\ufeff\\uffa0\\ufff9-\\ufffb]","g");var MAX_SCAN=2e5;var bare=text=>(text.length>MAX_SCAN?text.slice(0,MAX_SCAN/2)+"\n"+text.slice(-MAX_SCAN/2):text).replace(INVISIBLE,"");var PLACEHOLDER=/placeholder|your[-_ ]|example|changeme|change[-_]?me|redacted|dummy|replace[-_]?me|insert[-_]|\*{3,}|x{5,}|\.{3}|^(?:none|null|undefined|true|false)$/i;var REFERENCE=/^(?:\$(?:\{[^}]*\}|\(|[A-Za-z_]\w*$)|%[^%]*%$|<[^>]*>$|\{\{|process\.env|os\.environ|env[.[]|import\.meta|System\.getenv|secrets?\.|vault:|op:\/\/|ref\+|arn:|projects\/[^/]+\/secrets\/|gcp:|kms:|aws:|file:)/i;var CALL=/^[A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)*\(|^[A-Za-z_$][\w$]*\[/;var IDENT_PATH=/^[A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)+$/;var UUID=/^[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$/i;var NAME_LIKE=/^[a-z][a-z0-9]*(?:[-_./][a-z0-9]+){2,}$/;function entropy(v){const counts=new Map;for(const ch of v)counts.set(ch,(counts.get(ch)??0)+1);let h=0;for(const n of counts.values())h-=n/v.length*Math.log2(n/v.length);return h}function isReference(v){if(PLACEHOLDER.test(v)||REFERENCE.test(v)||CALL.test(v)||IDENT_PATH.test(v)||URL_NO_CREDS.test(v))return true;return NAME_LIKE.test(v)&&v.replace(/\D/g,"").length/v.length<.15}function plausibleSecret(v){if(v.length<8||v.length>256||/\s/.test(v)||UUID.test(v)||isReference(v))return false;const symbol=/[^A-Za-z0-9]/.test(v);const digit=/\d/.test(v);const classes=[/[a-z]/.test(v),/[A-Z]/.test(v),digit,symbol].filter(Boolean).length;return classes>=2&&(digit||symbol)&&entropy(v)>=2.5}var KEYED_MIN=20;var PLACEHOLDER_WORD=/(?:^|[^a-z])(?:your|placeholder|changeme|change[-_]?me|example|redacted|dummy|replace[-_]?me|insert)(?:[^a-z]|$)|\*{3,}|x{5,}|\.{3}|^(?:none|null|undefined|true|false)$/i;var URL_NO_CREDS=/^[a-z][a-z0-9+.-]{1,20}:\/\/[^\s@]*$/i;function hyphenName(v){const parts=v.split("-");return parts.length>=3&&parts.every(p=>/^[a-z0-9]{2,}$/.test(p)&&!/^[0-9a-f]{8,}$/.test(p))&&v.replace(/\D/g,"").length/v.length<.15}function keyedSecret(v){if(v.length<KEYED_MIN||v.length>256||/\s/.test(v))return false;return!(PLACEHOLDER_WORD.test(v)||REFERENCE.test(v)||CALL.test(v)||IDENT_PATH.test(v)||URL_NO_CREDS.test(v)||!UUID.test(v)&&hyphenName(v))}var KEY_NAME=/(?:api[_-]?key|secret|token|passw(?:or)?d|passwd|pwd|credential|private[_-]?key|auth(?!or))s?[A-Za-z0-9_-]{0,40}["']?\s*[:=]\s*/gi;var QUOTED=/(["'\x60])((?:(?!\1)[^\n]){1,256})\1/y;var BARE_VALUE=/[^\s"'\x60,;]{1,256}/y;var QUERY_VALUE=/[^\s"'\x60,;&]{1,256}/y;function assignmentSecret(text){let valueEnd=0;for(const m of text.matchAll(KEY_NAME)){if(m.index<valueEnd)continue;const at=m.index+m[0].length;let back=m.index;while(back>0&&m.index-back<64&&/[A-Za-z0-9_.-]/.test(text.charAt(back-1)))back--;const re=/["'\x60]/.test(text.charAt(at))?QUOTED:/[?&]/.test(text.charAt(back-1))?QUERY_VALUE:BARE_VALUE;re.lastIndex=at;const hit=re.exec(text);const v=hit&&(hit[2]??hit[0]);valueEnd=hit?at+hit[0].length:at;if(v&&(plausibleSecret(v)||keyedSecret(v)))return true}return false}function urlCredential(url){const pass=/^[^:]+:\/\/[^\s:@/]+:([^\s@/]+)@/.exec(url)?.[1];if(!pass||/\$\{|\{\{|%\(|%s/.test(pass))return false;return!/^(?:password|passwd|pass|pwd|secret|changeme|dbpassword|db_password|\$\w*|<.*>|\{.*\}|\*+|x+)$/i.test(pass)&&!PLACEHOLDER.test(pass)}var CHECKS={"bearer token":m=>!isReference(m[1]??""),"database url with credentials":m=>urlCredential(m[0]),"database url with password":m=>urlCredential(m[0])};var globals=new WeakMap;function matches(name,re,text){if(name==="key assignment")return assignmentSecret(text);const check=CHECKS[name];if(!check)return re.test(text);let g=globals.get(re);if(!g)globals.set(re,g=new RegExp(re.source,re.flags.includes("g")?re.flags:re.flags+"g"));for(const m of text.matchAll(g))if(check(m))return true;return false}var TRUNCATED="ruflo-screen: input exceeded the screening budget";var TRUNCATED_NAME="input too large to screen";var names=(rules,text)=>text===TRUNCATED?[TRUNCATED_NAME]:rules.filter(([name,re])=>matches(name,re,text)).map(([name])=>name);var hasSecretIn=(secrets,text)=>names(secrets,bare(text)).length>0;var NODES=2e4;var CHARS=2e6;var PER_STRING=15e5;var OVERLAP=2048;var BARE_KEY_MIN=8;function windows(text,out){if(text.length<=MAX_SCAN){out.push(text);return}for(let at=0;;at+=MAX_SCAN-OVERLAP){out.push(text.slice(at,at+MAX_SCAN));if(at+MAX_SCAN>=text.length)return}}function textsOf(input,limits={}){const out=[];let slots=limits.nodes??NODES;let chars=limits.chars??CHARS;const perString=limits.perString??PER_STRING;let truncated=false;const take=text=>{if(chars<=0){truncated=true;return}if(text.length<=Math.min(perString,chars)){chars-=text.length;windows(text,out);return}truncated=true;const half=Math.floor(Math.min(perString,chars)/2);chars-=2*half;windows(text.slice(0,half),out);windows(text.slice(-half),out)};const queue=[input];let head=0;for(;head<queue.length&&chars>0;head++){const node=queue[head];if(typeof node==="string")take(node);else if(Array.isArray(node)){let i=0;for(;i<node.length&&slots>0;i++,slots--)if(i in node)queue.push(node[i]);if(i<node.length)truncated=true}else if(typeof node==="object"&&node!==null){for(const k in node){if(slots--<=0){truncated=true;break}if(!Object.prototype.hasOwnProperty.call(node,k))continue;const v=node[k];if(typeof v==="string")queue.push(k+"="+v);else{if(k.length>=BARE_KEY_MIN)take(k);queue.push(v)}}}}if(queue.length>head)truncated=true;if(truncated)out.push(TRUNCATED);return out}var SECRETS=[...COMMON_SECRETS,["key assignment",/\b(?:api[_-]?key|secret|token|passw(?:or)?d|credential)s?["']?\s*[:=]\s*["']?[A-Za-z0-9/+=_.-]{16,}/i]];var secretNames=text=>names(SECRETS,bare(text));var hasSecret=text=>hasSecretIn(SECRETS,text);var HELP=["/ddd-mod status","/ddd-mod scan <text>","/ddd-mod contexts"].join("\n");async function answer(args,deps){const[verb="",...rest]=args.trim().split(/\s+/);const arg=rest.join(" ");if(verb===""||verb==="help")return HELP;if(verb==="status")return`guard ${deps.guard?"on":"off"} \xB7 calls blocked ${deps.stats.blocked}`;if(verb==="scan"){if(arg==="")return"usage: /ddd-mod scan <text>";const found=secretNames(arg);return found.length?`The guard would refuse that (${found.join(", ")}).`:"Nothing found: the guard would let that through."}if(verb==="contexts"){const found=[];for(const base of["src","src/contexts","src/modules"]){let entries;try{entries=await deps.list(base)}catch{continue}if(entries.some(e=>e.kind==="dir"&&e.name==="domain")&&base==="src")found.push("src (single domain)");for(const dir of entries.filter(e=>e.kind==="dir"&&e.name!=="domain").slice(0,40)){try{if((await deps.list(`${base}/${dir.name}`)).some(e=>e.kind==="dir"&&e.name==="domain"))found.push(`${base}/${dir.name}`)}catch{}}}return found.length?`${found.length} bounded context${found.length===1?"":"s"} (a folder with a domain/ layer):
${found.map(f=>`- ${f}`).join("\n")}`:"No bounded context found under src/, src/contexts or src/modules."}return`Unknown: ${verb}
-${HELP}`}var tail=name=>name.startsWith("mcp__")?name.slice(name.lastIndexOf("__")+2):name;var WRITERS=new Set(["memory_store","agentdb_hierarchical-store"]);var DOMAIN=/^(?:ddd|domain)-|^(?:context|aggregate):/;function isDomainWrite(input){const o=typeof input==="object"&&input!==null?input:{};return["key","parent","child"].some(k=>typeof o[k]==="string"&&DOMAIN.test(o[k]))}function verdict(tool,input){if(!WRITERS.has(tail(tool))||!isDomainWrite(input))return void 0;return textsOf(input).some(hasSecret)?"ruflo-ddd: this domain-model entry holds what looks like a secret (a key, token or password). The model records contexts and aggregates, not credentials.":void 0}runCodexHook({name:"ruflo-ddd",verdict,newStats,statusPath:STATUS_PATH,answer,statusText:(stats,now)=>statusText(stats,true,now),count:(stats,tool,input,reason)=>{if(reason!==void 0)stats.blocked++}}).catch(()=>hookFailure("ruflo-ddd"));
+${HELP}`}var tail=name=>name.startsWith("mcp__")?name.slice(name.lastIndexOf("__")+2):name;var WRITERS=new Set(["memory_store","agentdb_hierarchical-store"]);var DOMAIN=/^(?:ddd|domain)-|^(?:context|aggregate):/;function isDomainWrite(input){const o=typeof input==="object"&&input!==null?input:{};return["key","parent","child"].some(k=>typeof o[k]==="string"&&DOMAIN.test(o[k]))}function verdict(tool,input){if(!WRITERS.has(tail(tool))||!isDomainWrite(input))return void 0;return textsOf(input).some(hasSecret)?"ruflo-ddd: this domain-model entry holds what looks like a secret (a key, token or password). The model records contexts and aggregates, not credentials.":void 0}runCodexHook({name:"ruflo-ddd",writers:["memory_store","agentdb_hierarchical-store"],verdict,newStats,statusPath:STATUS_PATH,answer,statusText:(stats,now)=>statusText(stats,true,now),count:(stats,tool,input,reason)=>{if(reason!==void 0)stats.blocked++}}).catch(()=>hookFailure("ruflo-ddd"));
diff --git a/plugins/ruflo-ddd/hooks/codex.ts b/plugins/ruflo-ddd/hooks/codex.ts
index e38b1a0f1a..0d5eac3b5b 100644
--- a/plugins/ruflo-ddd/hooks/codex.ts
+++ b/plugins/ruflo-ddd/hooks/codex.ts
@@ -3,7 +3,7 @@ import { newStats, STATUS_PATH, statusText } from './status'
import { answer } from './command'
import { verdict } from './guard'
-runCodexHook({ name: 'ruflo-ddd', verdict, newStats, statusPath: STATUS_PATH, answer,
+runCodexHook({ name: 'ruflo-ddd', writers: ['memory_store', 'agentdb_hierarchical-store'], verdict, newStats, statusPath: STATUS_PATH, answer,
statusText: (stats, now) => statusText(stats, true, now),
count: (stats, tool, input, reason) => { if (reason !== undefined) stats.blocked++; },
}).catch(() => hookFailure('ruflo-ddd'))
diff --git a/plugins/ruflo-ddd/scripts/smoke.sh b/plugins/ruflo-ddd/scripts/smoke.sh
index 9338123106..bf1b4ca484 100755
--- a/plugins/ruflo-ddd/scripts/smoke.sh
+++ b/plugins/ruflo-ddd/scripts/smoke.sh
@@ -7,9 +7,9 @@ step() { printf "→ %s ... " "$1"; }
ok() { printf "PASS\n"; PASS=$((PASS+1)); }
bad() { printf "FAIL: %s\n" "$1"; FAIL=$((FAIL+1)); }
-step "1. plugin.json declares 0.3.3 with new keywords"
+step "1. plugin.json declares 0.3.4 with new keywords"
v=$(grep -E '"version"' "$ROOT/.claude-plugin/plugin.json" | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)
-if [[ "$v" != "0.3.3" ]]; then bad "expected 0.3.3, got '$v'"; else
+if [[ "$v" != "0.3.4" ]]; then bad "expected 0.3.4, got '$v'"; else
miss=""
for k in acl value-objects repositories mcp; do
grep -q "\"$k\"" "$ROOT/.claude-plugin/plugin.json" || miss="$miss $k"
diff --git a/plugins/ruflo-sparc/.claude-plugin/plugin.json b/plugins/ruflo-sparc/.claude-plugin/plugin.json
index 07d3562d54..fd7a83edf2 100644
--- a/plugins/ruflo-sparc/.claude-plugin/plugin.json
+++ b/plugins/ruflo-sparc/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "ruflo-sparc",
"description": "SPARC methodology — Specification, Pseudocode, Architecture, Refinement, Completion phases with gate checks",
- "version": "0.3.3",
+ "version": "0.3.4",
"author": {
"name": "ruvnet",
"url": "https://github.com/ruvnet"
diff --git a/plugins/ruflo-sparc/.codex-plugin/plugin.json b/plugins/ruflo-sparc/.codex-plugin/plugin.json
index a1958395c2..13b22116ef 100644
--- a/plugins/ruflo-sparc/.codex-plugin/plugin.json
+++ b/plugins/ruflo-sparc/.codex-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "ruflo-sparc",
"description": "SPARC methodology \u2014 Specification, Pseudocode, Architecture, Refinement, Completion phases with gate checks",
- "version": "0.3.3",
+ "version": "0.3.4",
"author": {
"name": "ruvnet",
"url": "https://github.com/ruvnet"
diff --git a/plugins/ruflo-sparc/README.md b/plugins/ruflo-sparc/README.md
index e7dc328083..8bb100b51e 100644
--- a/plugins/ruflo-sparc/README.md
+++ b/plugins/ruflo-sparc/README.md
@@ -149,3 +149,11 @@ The adapters need Node.js and contain no runtime SDK dependency.
This source change requires a released upstream package or an explicitly owned
source projection to reach installations. It does not patch foreign cache entries,
pin upstream updates, disable plugins, or claim an already published repair.
+
+Release both host manifests with the same patch version. Codex 0.160's published
+remote-bundle sync skips downloading a release whose version equals the installed
+version; merging same-version source does not establish automatic cache refresh.
+Its explicit native plugin install replaces the cached root atomically even at the
+same version. An owned projection must therefore refresh its upstream source
+generation and explicitly reinstall it; refreshing a marketplace catalog alone
+is not installation proof. No foreign cache entry should be edited in place.
diff --git a/plugins/ruflo-sparc/hooks/codex-hook.cjs b/plugins/ruflo-sparc/hooks/codex-hook.cjs
index d8d36a3fdf..edff591eb2 100644
--- a/plugins/ruflo-sparc/hooks/codex-hook.cjs
+++ b/plugins/ruflo-sparc/hooks/codex-hook.cjs
@@ -3,9 +3,9 @@
`);try{const courtesy=import_node_path.default.join(directory(import_node_path.default.join(event.cwd,import_node_path.default.dirname(plugin.statusPath))),import_node_path.default.basename(plugin.statusPath));const view=JSON.parse(plugin.statusText(stats,now));write(courtesy,`${JSON.stringify({...view,host:"codex",sessionId:event.session_id},null,2)}
`)}catch{}return stats}finally{import_node_fs.default.rmdirSync(lock)}}function validEvent(event){return plain(event)&&typeof event.cwd==="string"&&import_node_path.default.isAbsolute(event.cwd)&&typeof event.session_id==="string"&&event.session_id.length>0&&event.session_id.length<=512}async function runCodexHook(plugin){const mode=process.argv[2];if(mode==="--command"){const cwd=process.cwd();const view=snapshot(import_node_path.default.join(cwd,plugin.statusPath));const text=await plugin.answer(process.argv.slice(3).join(" "),{opts:{guard:true},guard:true,stats:view?.host==="codex"?view:plugin.newStats(),tools:async()=>[],list:async relative=>import_node_fs.default.readdirSync(import_node_path.default.join(cwd,relative),{withFileTypes:true}).map(entry=>({name:entry.name,kind:entry.isDirectory()?"dir":"file"}))});process.stdout.write(`${text}
`);return}const chunks=[];let bytes=0;for await(const chunk of process.stdin){bytes+=chunk.length;if(bytes>MAX_INPUT)throw new Error("Hook input exceeds bound");chunks.push(chunk)}const event=JSON.parse(Buffer.concat(chunks).toString("utf8"));if(!validEvent(event)||event.hook_event_name!==mode)throw new Error("Invalid hook envelope");if(mode==="SessionStart"){try{updateStatus(plugin,event,stats=>{if("startedMs"in stats&&!stats.startedMs)stats.startedMs=Date.now()})}catch{process.stderr.write(`${plugin.name}: courtesy status unavailable
-`)}return}if(mode!=="PreToolUse"||typeof event.tool_name!=="string"||!plain(event.tool_input))throw new Error("Invalid native tool event");const reason=plugin.verdict(event.tool_name,event.tool_input);try{updateStatus(plugin,event,stats=>plugin.count(stats,event.tool_name,event.tool_input,reason))}catch{process.stderr.write(`${plugin.name}: courtesy status unavailable
+`)}return}if(mode!=="PreToolUse"||typeof event.tool_name!=="string"||!Object.hasOwn(event,"tool_input"))throw new Error("Invalid native tool event");const shortName2=event.tool_name.startsWith("mcp__")?event.tool_name.slice(event.tool_name.lastIndexOf("__")+2):event.tool_name;if(plugin.writers.includes(shortName2)&&!plain(event.tool_input))throw new Error("Invalid guarded writer input");const reason=plugin.verdict(event.tool_name,event.tool_input);try{updateStatus(plugin,event,stats=>plugin.count(stats,event.tool_name,event.tool_input,reason))}catch{process.stderr.write(`${plugin.name}: courtesy status unavailable
`)}if(reason!==void 0)process.stdout.write(`${JSON.stringify({hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:reason}})}
`)}function hookFailure(plugin){process.stderr.write(`${plugin}: native hook input or adapter failed
`);process.exitCode=2}var newStats=()=>({checked:0,blocked:0,seen:{}});var STATUS_PATH=".claude-flow/sparc-mod/status.json";function statusText(stats,mode,nowMs){return`${JSON.stringify({version:1,updatedMs:nowMs,guard:mode.guard,...stats},null,2)}
`}var COMMON_SECRETS=[["private key",/-----BEGIN [A-Z ]*PRIVATE KEY-----/],["aws access key",/\b(?:AKIA|ASIA)[0-9A-Z]{16}\b/],["github token",/\b(?:gh[pousr]_[A-Za-z0-9]{30,}|github_pat_[A-Za-z0-9_]{40,})\b/],["slack token",/\bxox[abprs]-[A-Za-z0-9-]{10,}/],["slack webhook",/\bhooks\.slack\.com\/services\/T[A-Z0-9]{6,}\/B[A-Z0-9]{6,}\/[A-Za-z0-9]{16,}/],["google api key",/\bAIza[0-9A-Za-z_-]{35}\b/],["anthropic or openai key",/\bsk-(?:(?:ant|proj|svcacct|admin)-[A-Za-z0-9_-]{20,}|(?=[A-Za-z]{0,40}\d)[A-Za-z0-9]{32,})/],["stripe key",/\b[rs]k_live_[A-Za-z0-9]{16,}/],["npm token",/\bnpm_[A-Za-z0-9]{36}\b/],["huggingface token",/\bhf_[A-Za-z0-9]{30,}\b/],["sendgrid key",/\bSG\.[A-Za-z0-9_-]{16,}\.[A-Za-z0-9_-]{16,}/],["twilio key",/\bSK[0-9a-f]{32}\b/],["jwt",/\beyJ[A-Za-z0-9_-]{8,}\.eyJ[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}/],["bearer token",/\bBearer\s+([A-Za-z0-9._~+/=-]{24,})/],["database url with credentials",/\b[a-z][a-z0-9+.-]{1,20}:\/\/[^\s:@/]+:[^\s@/]{3,}@[^\s/]+/i]];var INVISIBLE=new RegExp("[\\u0000-\\u0008\\u000b-\\u001f\\u007f-\\u009f\\u00ad\\u034f\\u061c\\u115f\\u1160\\u17b4\\u17b5\\u180b-\\u180e\\u200b-\\u200f\\u2028-\\u202e\\u2060-\\u206f\\u3164\\ufe00-\\ufe0f\\ufeff\\uffa0\\ufff9-\\ufffb]","g");var MAX_SCAN=2e5;var bare=text=>(text.length>MAX_SCAN?text.slice(0,MAX_SCAN/2)+"\n"+text.slice(-MAX_SCAN/2):text).replace(INVISIBLE,"");var PLACEHOLDER=/placeholder|your[-_ ]|example|changeme|change[-_]?me|redacted|dummy|replace[-_]?me|insert[-_]|\*{3,}|x{5,}|\.{3}|^(?:none|null|undefined|true|false)$/i;var REFERENCE=/^(?:\$(?:\{[^}]*\}|\(|[A-Za-z_]\w*$)|%[^%]*%$|<[^>]*>$|\{\{|process\.env|os\.environ|env[.[]|import\.meta|System\.getenv|secrets?\.|vault:|op:\/\/|ref\+|arn:|projects\/[^/]+\/secrets\/|gcp:|kms:|aws:|file:)/i;var CALL=/^[A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)*\(|^[A-Za-z_$][\w$]*\[/;var IDENT_PATH=/^[A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)+$/;var UUID=/^[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$/i;var NAME_LIKE=/^[a-z][a-z0-9]*(?:[-_./][a-z0-9]+){2,}$/;function entropy(v){const counts=new Map;for(const ch of v)counts.set(ch,(counts.get(ch)??0)+1);let h=0;for(const n of counts.values())h-=n/v.length*Math.log2(n/v.length);return h}function isReference(v){if(PLACEHOLDER.test(v)||REFERENCE.test(v)||CALL.test(v)||IDENT_PATH.test(v)||URL_NO_CREDS.test(v))return true;return NAME_LIKE.test(v)&&v.replace(/\D/g,"").length/v.length<.15}function plausibleSecret(v){if(v.length<8||v.length>256||/\s/.test(v)||UUID.test(v)||isReference(v))return false;const symbol=/[^A-Za-z0-9]/.test(v);const digit=/\d/.test(v);const classes=[/[a-z]/.test(v),/[A-Z]/.test(v),digit,symbol].filter(Boolean).length;return classes>=2&&(digit||symbol)&&entropy(v)>=2.5}var KEYED_MIN=20;var PLACEHOLDER_WORD=/(?:^|[^a-z])(?:your|placeholder|changeme|change[-_]?me|example|redacted|dummy|replace[-_]?me|insert)(?:[^a-z]|$)|\*{3,}|x{5,}|\.{3}|^(?:none|null|undefined|true|false)$/i;var URL_NO_CREDS=/^[a-z][a-z0-9+.-]{1,20}:\/\/[^\s@]*$/i;function hyphenName(v){const parts=v.split("-");return parts.length>=3&&parts.every(p=>/^[a-z0-9]{2,}$/.test(p)&&!/^[0-9a-f]{8,}$/.test(p))&&v.replace(/\D/g,"").length/v.length<.15}function keyedSecret(v){if(v.length<KEYED_MIN||v.length>256||/\s/.test(v))return false;return!(PLACEHOLDER_WORD.test(v)||REFERENCE.test(v)||CALL.test(v)||IDENT_PATH.test(v)||URL_NO_CREDS.test(v)||!UUID.test(v)&&hyphenName(v))}var KEY_NAME=/(?:api[_-]?key|secret|token|passw(?:or)?d|passwd|pwd|credential|private[_-]?key|auth(?!or))s?[A-Za-z0-9_-]{0,40}["']?\s*[:=]\s*/gi;var QUOTED=/(["'\x60])((?:(?!\1)[^\n]){1,256})\1/y;var BARE_VALUE=/[^\s"'\x60,;]{1,256}/y;var QUERY_VALUE=/[^\s"'\x60,;&]{1,256}/y;function assignmentSecret(text){let valueEnd=0;for(const m of text.matchAll(KEY_NAME)){if(m.index<valueEnd)continue;const at=m.index+m[0].length;let back=m.index;while(back>0&&m.index-back<64&&/[A-Za-z0-9_.-]/.test(text.charAt(back-1)))back--;const re=/["'\x60]/.test(text.charAt(at))?QUOTED:/[?&]/.test(text.charAt(back-1))?QUERY_VALUE:BARE_VALUE;re.lastIndex=at;const hit=re.exec(text);const v=hit&&(hit[2]??hit[0]);valueEnd=hit?at+hit[0].length:at;if(v&&(plausibleSecret(v)||keyedSecret(v)))return true}return false}function urlCredential(url){const pass=/^[^:]+:\/\/[^\s:@/]+:([^\s@/]+)@/.exec(url)?.[1];if(!pass||/\$\{|\{\{|%\(|%s/.test(pass))return false;return!/^(?:password|passwd|pass|pwd|secret|changeme|dbpassword|db_password|\$\w*|<.*>|\{.*\}|\*+|x+)$/i.test(pass)&&!PLACEHOLDER.test(pass)}var CHECKS={"bearer token":m=>!isReference(m[1]??""),"database url with credentials":m=>urlCredential(m[0]),"database url with password":m=>urlCredential(m[0])};var globals=new WeakMap;function matches(name,re,text){if(name==="key assignment")return assignmentSecret(text);const check=CHECKS[name];if(!check)return re.test(text);let g=globals.get(re);if(!g)globals.set(re,g=new RegExp(re.source,re.flags.includes("g")?re.flags:re.flags+"g"));for(const m of text.matchAll(g))if(check(m))return true;return false}var TRUNCATED="ruflo-screen: input exceeded the screening budget";var TRUNCATED_NAME="input too large to screen";var names=(rules,text)=>text===TRUNCATED?[TRUNCATED_NAME]:rules.filter(([name,re])=>matches(name,re,text)).map(([name])=>name);var hasSecretIn=(secrets,text)=>names(secrets,bare(text)).length>0;var NODES=2e4;var CHARS=2e6;var PER_STRING=15e5;var OVERLAP=2048;var BARE_KEY_MIN=8;function windows(text,out){if(text.length<=MAX_SCAN){out.push(text);return}for(let at=0;;at+=MAX_SCAN-OVERLAP){out.push(text.slice(at,at+MAX_SCAN));if(at+MAX_SCAN>=text.length)return}}function textsOf(input,limits={}){const out=[];let slots=limits.nodes??NODES;let chars=limits.chars??CHARS;const perString=limits.perString??PER_STRING;let truncated=false;const take=text=>{if(chars<=0){truncated=true;return}if(text.length<=Math.min(perString,chars)){chars-=text.length;windows(text,out);return}truncated=true;const half=Math.floor(Math.min(perString,chars)/2);chars-=2*half;windows(text.slice(0,half),out);windows(text.slice(-half),out)};const queue=[input];let head=0;for(;head<queue.length&&chars>0;head++){const node=queue[head];if(typeof node==="string")take(node);else if(Array.isArray(node)){let i=0;for(;i<node.length&&slots>0;i++,slots--)if(i in node)queue.push(node[i]);if(i<node.length)truncated=true}else if(typeof node==="object"&&node!==null){for(const k in node){if(slots--<=0){truncated=true;break}if(!Object.prototype.hasOwnProperty.call(node,k))continue;const v=node[k];if(typeof v==="string")queue.push(k+"="+v);else{if(k.length>=BARE_KEY_MIN)take(k);queue.push(v)}}}}if(queue.length>head)truncated=true;if(truncated)out.push(TRUNCATED);return out}var SECRETS=[...COMMON_SECRETS,["key assignment",/\b(?:api[_-]?key|secret|token|passw(?:or)?d|credential)s?["']?\s*[:=]\s*["']?[A-Za-z0-9/+=_.-]{16,}/i]];var secretsIn=text=>names(SECRETS,bare(text));var hasSecret=text=>hasSecretIn(SECRETS,text);var HELP=["/sparc-mod status","/sparc-mod scan <text>","/sparc-mod phases"].join("\n");async function answer(args,deps){const[verb="",...rest]=args.trim().split(/\s+/);const arg=rest.join(" ");const{opts,stats}=deps;if(verb===""||verb==="help")return HELP;if(verb==="status"){const seen=Object.entries(stats.seen).map(([k,n])=>`${k} ${n}`).join(" \xB7 ");return[`guard ${opts.guard?"on":"off"} \xB7 checked ${stats.checked} \xB7 blocked ${stats.blocked}`,seen===""?"no sparc-artifact calls this session":seen].join("\n")}if(verb==="scan"){if(arg==="")return"usage: /sparc-mod scan <text>";const found=secretsIn(arg);return found.length?`The guard would refuse that (looks like: ${found.join(", ")}).`:"Nothing found: the guard would let that through."}if(verb==="phases")return["S specification","P pseudocode","A architecture","R refinement","C completion","Artifacts go in memory namespaces starting with sparc; the guard screens them for secrets."].join("\n");return`Unknown: ${verb}
-${HELP}`}var shortName=name=>name.startsWith("mcp__")&&name.lastIndexOf("__")>5?name.slice(name.lastIndexOf("__")+2):name;var field=(input,key)=>{const v=typeof input==="object"&&input!==null?input[key]:void 0;return typeof v==="string"?v:""};var NS=/^sparc/i;var WRITERS=new Set(["memory_store","agentdb_hierarchical-store","agentdb_pattern-store"]);function watched(tool,input){if(!WRITERS.has(shortName(tool)))return void 0;return NS.test(field(input,"namespace"))?"sparc artifact write":void 0}function verdict(tool,input){if(watched(tool,input)===void 0)return void 0;return textsOf(input).some(hasSecret)?"ruflo-sparc: this spec or artifact holds what looks like a secret (a key, token or password). Write a placeholder and name where the real value lives.":void 0}runCodexHook({name:"ruflo-sparc",verdict,newStats,statusPath:STATUS_PATH,answer,statusText:(stats,now)=>statusText(stats,{guard:true},now),count:(stats,tool,input,reason)=>{const label=watched(tool,input);if(label!==void 0){stats.checked++;stats.seen[label]=(stats.seen[label]??0)+1;if(reason!==void 0){stats.blocked++;stats.lastReason=reason.slice(0,160)}}}}).catch(()=>hookFailure("ruflo-sparc"));
+${HELP}`}var shortName=name=>name.startsWith("mcp__")&&name.lastIndexOf("__")>5?name.slice(name.lastIndexOf("__")+2):name;var field=(input,key)=>{const v=typeof input==="object"&&input!==null?input[key]:void 0;return typeof v==="string"?v:""};var NS=/^sparc/i;var WRITERS=new Set(["memory_store","agentdb_hierarchical-store","agentdb_pattern-store"]);function watched(tool,input){if(!WRITERS.has(shortName(tool)))return void 0;return NS.test(field(input,"namespace"))?"sparc artifact write":void 0}function verdict(tool,input){if(watched(tool,input)===void 0)return void 0;return textsOf(input).some(hasSecret)?"ruflo-sparc: this spec or artifact holds what looks like a secret (a key, token or password). Write a placeholder and name where the real value lives.":void 0}runCodexHook({name:"ruflo-sparc",writers:["memory_store","agentdb_hierarchical-store","agentdb_pattern-store"],verdict,newStats,statusPath:STATUS_PATH,answer,statusText:(stats,now)=>statusText(stats,{guard:true},now),count:(stats,tool,input,reason)=>{const label=watched(tool,input);if(label!==void 0){stats.checked++;stats.seen[label]=(stats.seen[label]??0)+1;if(reason!==void 0){stats.blocked++;stats.lastReason=reason.slice(0,160)}}}}).catch(()=>hookFailure("ruflo-sparc"));
diff --git a/plugins/ruflo-sparc/hooks/codex.ts b/plugins/ruflo-sparc/hooks/codex.ts
index 86b1288bba..4511646a0f 100644
--- a/plugins/ruflo-sparc/hooks/codex.ts
+++ b/plugins/ruflo-sparc/hooks/codex.ts
@@ -3,7 +3,7 @@ import { newStats, STATUS_PATH, statusText } from './status'
import { answer } from './command'
import { verdict, watched } from './guard'
-runCodexHook({ name: 'ruflo-sparc', verdict, newStats, statusPath: STATUS_PATH, answer,
+runCodexHook({ name: 'ruflo-sparc', writers: ['memory_store', 'agentdb_hierarchical-store', 'agentdb_pattern-store'], verdict, newStats, statusPath: STATUS_PATH, answer,
statusText: (stats, now) => statusText(stats, { guard: true }, now),
count: (stats, tool, input, reason) => { const label = watched(tool, input); if (label !== undefined) { stats.checked++; stats.seen[label] = (stats.seen[label] ?? 0) + 1; if (reason !== undefined) { stats.blocked++; stats.lastReason = reason.slice(0, 160); } } },
}).catch(() => hookFailure('ruflo-sparc'))
diff --git a/plugins/ruflo-sparc/scripts/smoke.sh b/plugins/ruflo-sparc/scripts/smoke.sh
index d6be8d0389..d60d920769 100755
--- a/plugins/ruflo-sparc/scripts/smoke.sh
+++ b/plugins/ruflo-sparc/scripts/smoke.sh
@@ -7,9 +7,9 @@ step() { printf "→ %s ... " "$1"; }
ok() { printf "PASS\n"; PASS=$((PASS+1)); }
bad() { printf "FAIL: %s\n" "$1"; FAIL=$((FAIL+1)); }
-step "1. plugin.json declares 0.3.3 with new keywords"
+step "1. plugin.json declares 0.3.4 with new keywords"
v=$(grep -E '"version"' "$ROOT/.claude-plugin/plugin.json" | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)
-if [[ "$v" != "0.3.3" ]]; then bad "expected 0.3.3, got '$v'"; else
+if [[ "$v" != "0.3.4" ]]; then bad "expected 0.3.4, got '$v'"; else
miss=""
for k in mcp phase-gates quality-gates; do
grep -q "\"$k\"" "$ROOT/.claude-plugin/plugin.json" || miss="$miss $k"
diff --git a/scripts/lib/codex-mod-runtime.d.mts b/scripts/lib/codex-mod-runtime.d.mts
index 55ea2ca38f..dfb8df6068 100644
--- a/scripts/lib/codex-mod-runtime.d.mts
+++ b/scripts/lib/codex-mod-runtime.d.mts
@@ -1,5 +1,6 @@
export type NativePlugin<Stats extends object> = {
name: string;
+ writers: readonly string[];
verdict(tool: string, input: unknown): string | undefined;
newStats(): Stats;
statusPath: string;
diff --git a/scripts/lib/codex-mod-runtime.mjs b/scripts/lib/codex-mod-runtime.mjs
index 9078f28e79..c51422ada3 100644
--- a/scripts/lib/codex-mod-runtime.mjs
+++ b/scripts/lib/codex-mod-runtime.mjs
@@ -92,7 +92,11 @@ export async function runCodexHook(plugin) {
catch { process.stderr.write(`${plugin.name}: courtesy status unavailable\n`); }
return; // No extra instructions or model turn.
}
- if (mode !== 'PreToolUse' || typeof event.tool_name !== 'string' || !plain(event.tool_input)) throw new Error('Invalid native tool event');
+ if (mode !== 'PreToolUse' || typeof event.tool_name !== 'string' || !Object.hasOwn(event, 'tool_input')) throw new Error('Invalid native tool event');
+ // Native freeform tools carry arbitrary JSON (including strings), not just objects.
+ // A malformed memory writer cannot bypass scope checks by hiding namespace/key fields.
+ const shortName = event.tool_name.startsWith('mcp__') ? event.tool_name.slice(event.tool_name.lastIndexOf('__') + 2) : event.tool_name;
+ if (plugin.writers.includes(shortName) && !plain(event.tool_input)) throw new Error('Invalid guarded writer input');
const reason = plugin.verdict(event.tool_name, event.tool_input);
try { updateStatus(plugin, event, (stats) => plugin.count(stats, event.tool_name, event.tool_input, reason)); }
catch { process.stderr.write(`${plugin.name}: courtesy status unavailable\n`); }
diff --git a/tests/plugins/codex-mod-hooks.test.mjs b/tests/plugins/codex-mod-hooks.test.mjs
index d428653229..d56c847021 100644
--- a/tests/plugins/codex-mod-hooks.test.mjs
+++ b/tests/plugins/codex-mod-hooks.test.mjs
@@ -53,6 +53,20 @@ for (const [name, fixture] of Object.entries(fixtures)) {
const wrongTool = run(name, 'PreToolUse', { tool_name: 'mcp__ruflo__memory_search', tool_input: fixture.input });
assert.equal(wrongTool.status, 0); assert.equal(wrongTool.stdout, '');
});
+ test(`${name}: native arbitrary-JSON inputs pass for unrelated tools, malformed memory writers fail closed`, () => {
+ for (const input of ['*** Begin Patch\n*** End Patch', ['raw', 'arguments'], 7, true, null]) {
+ for (const tool of ['apply_patch', 'mcp__other__unrelated_tool']) {
+ const out = run(name, 'PreToolUse', { tool_name: tool, tool_input: input });
+ assert.equal(out.status, 0, out.stderr); assert.equal(out.stdout, '');
+ }
+ const guarded = run(name, 'PreToolUse', { tool_name: `mcp__ruflo__${fixture.tool}`, tool_input: input });
+ assert.equal(guarded.status, 2); assert.equal(guarded.stdout, '');
+ assert.equal(guarded.stderr, `ruflo-${name}: native hook input or adapter failed\n`);
+ }
+ const missing = run(name, 'PreToolUse', { tool_name: 'apply_patch' }); assert.equal(missing.status, 2);
+ const secret = run(name, 'PreToolUse', event(fixture));
+ assert.equal(JSON.parse(secret.stdout).hookSpecificOutput.permissionDecision, 'deny');
+ });
test(`${name}: session counters persist across processes, initialize courtesy view, never retain tool input`, () => {
const started = run(name, 'SessionStart', {}); assert.equal(started.status, 0); assert.equal(started.stdout, '');
const denied = run(name, 'PreToolUse', event(fixture)); assert.equal(denied.status, 0);