🌊 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
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
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.jsonindex 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.mdindex 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 ownedsource 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.cjsindex 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.tsindex 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.jsonindex 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.jsonindex 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.mdindex 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 ownedsource 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.cjsindex 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.tsindex 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.shindex 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'"; elsemiss=""for k in acl value-objects repositories mcp; dogrep -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.jsonindex 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.jsonindex 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.mdindex 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 ownedsource 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.cjsindex 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.tsindex 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.shindex 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'"; elsemiss=""for k in mcp phase-gates quality-gates; dogrep -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.mtsindex 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.mjsindex 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.mjsindex 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);