chore: import upstream snapshot with attribution

tests/scripts/orchestrate-codex-worker.test.js

@@ -0,0 +1,63 @@
+'use strict';
+
+const assert = require('assert');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const SCRIPT = path.join(__dirname, '..', '..', 'scripts', 'orchestrate-codex-worker.sh');
+
+console.log('=== Testing orchestrate-codex-worker.sh ===\n');
+
+let passed = 0;
+let failed = 0;
+
+function test(desc, fn) {
+  try {
+    fn();
+    console.log(`  ✓ ${desc}`);
+    passed++;
+  } catch (error) {
+    console.log(`  ✗ ${desc}: ${error.message}`);
+    failed++;
+  }
+}
+
+test('fails fast for an unreadable task file and records failure artifacts', () => {
+  const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'ecc-orch-worker-'));
+  const handoffFile = path.join(tempRoot, '.orchestration', 'docs', 'handoff.md');
+  const statusFile = path.join(tempRoot, '.orchestration', 'docs', 'status.md');
+  const missingTaskFile = path.join(tempRoot, '.orchestration', 'docs', 'task.md');
+
+  try {
+    spawnSync('git', ['init'], { cwd: tempRoot, stdio: 'ignore' });
+
+    const result = spawnSync('bash', [SCRIPT, missingTaskFile, handoffFile, statusFile], {
+      cwd: tempRoot,
+      encoding: 'utf8'
+    });
+
+    assert.notStrictEqual(result.status, 0, 'Script should fail when task file is unreadable');
+    assert.ok(fs.existsSync(statusFile), 'Script should still write a status file');
+    assert.ok(fs.existsSync(handoffFile), 'Script should still write a handoff file');
+
+    const statusContent = fs.readFileSync(statusFile, 'utf8');
+    const handoffContent = fs.readFileSync(handoffFile, 'utf8');
+
+    assert.ok(statusContent.includes('- State: failed'), 'Status file should record the failure state');
+    assert.ok(
+      statusContent.includes('task file is missing or unreadable'),
+      'Status file should explain the task-file failure'
+    );
+    assert.ok(
+      handoffContent.includes('Task file is missing or unreadable'),
+      'Handoff file should explain the task-file failure'
+    );
+  } finally {
+    fs.rmSync(tempRoot, { recursive: true, force: true });
+  }
+});
+
+console.log(`\n=== Results: ${passed} passed, ${failed} failed ===`);
+if (failed > 0) process.exit(1);