affaan-m/ECC · error

artifact not found: ${file}

Error message

artifact not found: ${file}

What it means

cmdOpen resolved the supplied artifact path against the working directory and fs.existsSync returned false, so there is nothing to open in the canvas. It fires after the path-presence check but before the server is ensured.

Source

Thrown at scripts/plan-canvas.js:226

  }
}

function output(payload) {
  process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
}

async function cmdStatus({ stateDir, port }) {
  const health = await healthCheck(port);
  if (!health) {
    return { server: 'not running', hint: 'open an artifact to start one', stateDir };
  }
  const sessions = await request(port, 'GET', '/api/sessions');
  return { server: `http://${DEFAULT_HOST}:${port}`, version: health.version, sessions: sessions.body.sessions };
}

async function cmdOpen(file, args, { stateDir, port }) {
  if (!file) throw new Error('open requires a file path');
  if (!fs.existsSync(path.resolve(file))) throw new Error(`artifact not found: ${file}`);
  await ensureServer({ stateDir, port });
  const res = await request(port, 'POST', '/api/sessions', {
    file: path.resolve(file),
    reopen: args.includes('--reopen')
  });
  if (res.statusCode === 409) return res.body;
  if (res.statusCode !== 200) throw new Error(res.body.error || `open failed (HTTP ${res.statusCode})`);
  const url = `http://${DEFAULT_HOST}:${port}${res.body.url}`;
  const launched = args.includes('--no-open') ? false : openBrowser(url);
  return {
    status: 'open',
    url,
    browser: launched ? 'opened' : 'not opened',
    next_step:
      'Run `ecc-plan-canvas await <file>` and leave it running; it returns when the human sends feedback, a verdict, or ends the session.'
  };
}

View on GitHub (pinned to 06c5e118c4)

Solutions

1. Verify the referenced path, id, or resource exists and is spelled correctly, then retry.

When it happens

Trigger: Triggered when plan-canvas.js rejects the current invocation: artifact not found: <value>

Common situations: Occurs while running scripts/plan-canvas.js with invalid arguments, missing flags, or a failing external dependency; the guard at scripts/plan-canvas.js:226 aborts the command with this message.

AI-assisted analysis of affaan-m/ECC@06c5e118c4 (2026-08-18). Data as JSON: /api/errors/d559ce081fb2d24c. Report an issue: GitHub.