Skip to content

ethanplusai/codex-on-crack / plugins/codex-on-crack/skills/crack

Lead substantial Codex builds with one configured implementation worker and lead acceptance. Use when the user requests codex-on-crack, names a model to delegate work to, asks to run subagents through Claude, or requests a lead/worker split. Keep host-only work direct; honor explicit external model choices. Workers must not invoke this orchestrator.

FileKindSize
SKILL.mdskill md8.0 KB
agents/openai.yamlconfig300 B
references/build-records.mdmarkdown2.7 KB
references/checkpoint.mdmarkdown1.3 KB
references/external-lead.mdmarkdown13.9 KB
references/measurement.mdmarkdown1.8 KB
references/model-selection.mdmarkdown2.2 KB
references/parallel.mdmarkdown1.7 KB
references/policy.mdmarkdown494 B
references/replay.mdmarkdown3.2 KB
references/verification.mdmarkdown2.1 KB
references/worker-contract.mdmarkdown1.3 KB
scripts/doctor.mjsscript608 B
scripts/lead.mjsscript26.0 KB
scripts/lib/catalog.mjsscript5.6 KB
scripts/lib/changes.mjsscript13.3 KB
scripts/lib/config.mjsscript6.5 KB
scripts/lib/external-lead.mjsscript56.7 KB
scripts/lib/io.mjsscript3.8 KB
scripts/lib/lead-protocol.mjsscript25.9 KB
scripts/lib/plan.mjsscript9.2 KB
scripts/lib/readiness.mjsscript6.0 KB
scripts/lib/report.mjsscript10.7 KB
scripts/lib/roles.mjsscript8.9 KB
scripts/lib/routing.mjsscript2.7 KB
scripts/lib/toml.mjsscript785 B
scripts/lib/trial.mjsscript12.4 KB
scripts/report.mjsscript2.7 KB
scripts/select.mjsscript3.9 KB
scripts/setup.mjsscript7.0 KB
scripts/trial.mjsscript1.8 KB
scripts/validate-plan.mjsscript2.6 KB
scripts/worktree.mjsscript7.8 KB
templates/checkpoint.mdmarkdown903 B
templates/plan.jsonconfig680 B
templates/spec.mdmarkdown742 B
templates/task-brief.mdmarkdown2.5 KB
templates/task-report.mdmarkdown1.5 KB
viewer/README.mdmarkdown5.9 KB
viewer/bridge.mjsscript16.6 KB
viewer/fixtures/sample.jsonconfig8.2 KB
viewer/package.jsonmanifest187 B
viewer/public/app.mjsscript8.8 KB
viewer/public/index.htmlother1.8 KB
viewer/public/style.cssother4.4 KB
viewer/serve.mjsscript11.2 KB
viewer/src/adapter.mjsscript9.9 KB
viewer/src/emit.mjsscript992 B
viewer/src/model.mjsscript8.9 KB
viewer/src/server.mjsscript4.1 KB
viewer/src/tail.mjsscript1.9 KB
viewer/test/browser.mjsscript2.6 KB
viewer/test/server.test.mjsscript3.2 KB
viewer/test/usage.test.mjsscript9.0 KB
viewer/test/viewer.test.mjsscript5.1 KB

viewer/test/viewer.test.mjs

View on GitHub
import test from 'node:test';import assert from 'node:assert/strict';import fs from 'node:fs/promises';import os from 'node:os';import path from 'node:path';
import {Adapter,selectEvents} from '../src/adapter.mjs';import {Tail} from '../src/tail.mjs';import {reduceEvents,validateEvent} from '../src/model.mjs';
const at='2026-09-28T12:00:00Z';const record=(type,payload,timestamp=at)=>({type,payload,timestamp});
const meta=(id,parent)=>record('session_meta',{id,source:parent?{subagent:{thread_spawn:{parent_thread_id:parent}}}:'cli'});
function adapter(id,parent){const a=new Adapter({source:id});a.ingest(meta(id,parent),1);return a}
test('root and descendants included, unrelated files excluded',()=>{const root=adapter('root'),child=adapter('child','root'),other=adapter('other');assert.deepEqual(new Set(selectEvents([root,child,other],'root').map(e=>e.agentId)),new Set(['root','child']))});
test('completion is returned, not accepted; next turn restarts',()=>{const a=adapter('child','root');a.ingest(record('event_msg',{type:'task_complete'}),2);assert.equal(reduceEvents(a.events)[0].status,'Returned · awaiting review');a.ingest(record('event_msg',{type:'task_started'}),3);assert.equal(reduceEvents(a.events)[0].status,'Working')});
test('reasoning and tool bodies are never emitted; plan text opt-in',()=>{const a=adapter('root');a.ingest(record('response_item',{type:'reasoning',summary:'SECRET'}),2);a.ingest(record('response_item',{type:'function_call',name:'exec_command',arguments:'SECRET'}),3);a.ingest(record('response_item',{type:'function_call',name:'update_plan',arguments:JSON.stringify({plan:[{step:'SECRET',status:'in_progress'}]})}),4);assert(!JSON.stringify(a.events).includes('SECRET'));assert.equal(reduceEvents(a.events)[0].steps[0].step,'Plan step 1')});
test('bad timestamps and plans reject without false completion',()=>{const a=adapter('root');a.ingest(record('event_msg',{type:'task_complete'},'oops'),2);a.ingest(record('response_item',{type:'function_call',name:'update_plan',arguments:JSON.stringify({plan:[{step:'a',status:'fake'}]})}),3);assert.equal(a.errors,2);assert.notEqual(reduceEvents(a.events)[0].status,'Accepted')});
test('duplicate events do not duplicate history',()=>{const a=adapter('root');assert.equal(reduceEvents([...a.events,...a.events])[0].history.length,1)});
test('since retains metadata but excludes historical workers',()=>{const root=adapter('root'),old=adapter('old','root');root.ingest(record('event_msg',{type:'task_started'},'2026-09-28T13:00:00Z'),2);assert.deepEqual(new Set(selectEvents([root,old],'root','2026-09-28T12:30:00Z').map(e=>e.agentId)),new Set(['root']))});
test('sample includes correction, acceptance and distinct verification',async()=>{const f=JSON.parse(await fs.readFile(new URL('../fixtures/sample.json',import.meta.url)));f.events.forEach(validateEvent);const agents=reduceEvents(f.events);assert.equal(agents.find(a=>a.id==='worker').status,'Accepted');assert.equal(agents.find(a=>a.id==='lead').status,'Turn complete')});
test('tail handles partial UTF8, malformed lines, append, truncate, and missing files',async()=>{const dir=await fs.mkdtemp(path.join(os.tmpdir(),'viewer-'));try{const file=path.join(dir,'log.jsonl');const row=JSON.stringify(meta('root'))+'\n';await fs.writeFile(file,row.slice(0,12));const t=new Tail(file,0,false);await t.poll();assert.equal(t.adapter.events.length,0);await fs.appendFile(file,row.slice(12)+'bad\n');await t.poll();assert.equal(t.adapter.events.length,1);assert.equal(t.adapter.errors,1);await fs.appendFile(file,JSON.stringify(record('event_msg',{type:'task_started'}))+'\n');await t.poll();assert.equal(reduceEvents(t.adapter.events)[0].status,'Working');await fs.writeFile(file,JSON.stringify(meta('new'))+'\n');await t.poll();assert.equal(t.adapter.id,'new');await fs.unlink(file);await t.poll();assert.equal(t.status,'Unavailable')}finally{await fs.rm(dir,{recursive:true,force:true})}});
test('native task-name delegation aliases to the attached child session',()=>{const root=adapter('root');root.ingest(record('response_item',{type:'function_call',name:'spawn_agent',call_id:'call',arguments:'{"task_name":"builder"}'}),2);root.ingest(record('response_item',{type:'function_call_output',call_id:'call',output:'{"task_name":"/root/builder"}'}),3);const child=adapter('child','root');child.agentPath='/root/builder';assert.equal(reduceEvents(selectEvents([root,child],'root')).length,2)});
test('explicit event feed validates and preserves review evidence',()=>{const a=new Adapter({source:'explicit',normalized:true});a.ingest({schemaVersion:1,eventId:'1',agentId:'root',at,type:'review.accepted',data:{}},1);a.ingest({schemaVersion:1,eventId:'bad',agentId:'root',at,type:'invented',data:{}},2);assert.equal(a.errors,1);assert.equal(reduceEvents(a.events)[0].status,'Accepted')});
test('explicit feed privacy drops arbitrary payload and hides descriptions',()=>{const a=new Adapter({source:'explicit',normalized:true});a.ingest({schemaVersion:1,eventId:'1',agentId:'root',at,type:'agent.created',extra:'SECRET',data:{title:'SECRET',assignment:'SECRET',extra:'SECRET'}},1);assert(!JSON.stringify(a.events).includes('SECRET'))});
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall