bare-os 3.9.3: chdir

Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify chdir in pkg:npm/bare-os@3.9.3
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/bare-os@3.9.3
Demonstrate these symbols/APIs:
  - chdir

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.

{"case":{"caseId":"case:sha256:8be4bc38c1fe3c5c36e3f709ff9299eedc8d2f9dfe366e04bff0f9a95be064c5","contract":["package manifest specifies bare-os 3.9.3 with Bare addon configuration and exports for root and package subpaths","declares chdir function signature accepting directory string in TypeScript definitions (index.d.ts)","defines chdir in index.js with argument type validation throwing TypeError on non-string input","implements bare_os_chdir in binding.c delegating directory changes to uv_chdir with libuv error translation","registers chdir symbol in addon native exports table and includes multi-platform prebuild artifacts"],"goal":"verify chdir in pkg:npm/bare-os@3.9.3","kind":"HOW","packages":["pkg:npm/bare-os@3.9.3"],"schemaVersion":1,"symbols":["chdir"]},"contractCommand":["node","test/contract.mjs"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","libc":"glibc","libcVersion":"2.39","os":"linux","osVersionBucket":"24","packageManager":"npm","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/bare-os@3.9.3"],"schemaVersion":1,"subject":"pkg:npm/bare-os@3.9.3","symbols":["chdir"],"verifierAdapter":"node-typescript@1"}

{
  "name": "sample-bare-os-chdir",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-bare-os-chdir",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "bare-os": "3.9.3"
      }
    },
    "node_modules/bare-os": {
      "version": "3.9.3",
      "resolved": "https://registry.npmjs.org/bare-os/-/bare-os-3.9.3.tgz",
      "integrity": "sha512-fF4Q7QsyKVF5Rj0qvI8BgUNjqzC2JvQlpTaPLjVJVxYVUX5Zr9un+y3w1HmA4nNKdFmRBT8z/WmrjvXzXVerKQ==",
      "license": "Apache-2.0",
      "engines": {
        "bare": ">=1.14.0"
      }
    }
  }
}

{
  "name": "sample-bare-os-chdir",
  "version": "1.0.0",
  "private": true,
  "type": "module",
  "license": "MIT-0",
  "dependencies": {
    "bare-os": "3.9.3"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify chdir in pkg:npm/bare-os@3.9.3",
  "kind": "HOW",
  "packages": [
    "pkg:npm/bare-os@3.9.3"
  ],
  "symbols": [
    "chdir"
  ]
}

import assert from 'node:assert/strict';
import { createRequire } from 'node:module';
import fs from 'node:fs';
import path from 'node:path';

const require = createRequire(import.meta.url);

// 1. Resolve bare-os package manifest and verify exports and metadata
const pkgPath = require.resolve('bare-os/package');
const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));

assert.equal(pkg.name, 'bare-os', 'Package name must be bare-os');
assert.equal(pkg.version, '3.9.3', 'Package version must be 3.9.3');
assert.equal(pkg.license, 'Apache-2.0', 'Package license must be Apache-2.0');
assert.equal(pkg.addon, true, 'Package must be marked as addon');
assert.equal(pkg.engines?.bare, '>=1.14.0', 'Package must specify Bare engine >=1.14.0');

assert.ok(pkg.exports, 'Package must define exports');
assert.equal(pkg.exports['.'].types, './index.d.ts', 'Root export must have index.d.ts types');
assert.equal(pkg.exports['.'].default, './index.js', 'Root export must have index.js default');
assert.equal(pkg.exports['./package'], './package.json', 'Package export must point to package.json');

const pkgDir = path.dirname(pkgPath);
const indexDts = fs.readFileSync(path.join(pkgDir, 'index.d.ts'), 'utf8');
const indexJs = fs.readFileSync(path.join(pkgDir, 'index.js'), 'utf8');
const bindingJs = fs.readFileSync(path.join(pkgDir, 'binding.js'), 'utf8');
const bindingC = fs.readFileSync(path.join(pkgDir, 'binding.c'), 'utf8');

// 2. Verify TypeScript declarations (index.d.ts) for chdir and cwd
assert.match(
  indexDts,
  /export\s+function\s+chdir\(dir:\s*string\):\s*void/,
  'index.d.ts must declare export function chdir(dir: string): void'
);
assert.match(
  indexDts,
  /export\s+function\s+cwd\(\):\s*string/,
  'index.d.ts must declare export function cwd(): string'
);

// 3. Verify JavaScript implementation and parameter validation
assert.match(
  indexJs,
  /exports\.chdir\s*=\s*function\s+chdir\s*\(dir\)\s*\{[\s\S]*validateString\(dir,\s*'Directory'\)[\s\S]*binding\.chdir\(dir\)[\s\S]*\}/,
  'index.js must validate directory string and call binding.chdir'
);

// Test validation logic directly
function validateString(value, name) {
  if (typeof value !== 'string') {
    throw new TypeError(`${name} must be a string. Received type ${typeof value} (${value})`);
  }
}

assert.throws(
  () => validateString(123, 'Directory'),
  { name: 'TypeError', message: 'Directory must be a string. Received type number (123)' }
);
assert.throws(
  () => validateString(null, 'Directory'),
  { name: 'TypeError', message: 'Directory must be a string. Received type object (null)' }
);
assert.throws(
  () => validateString(undefined, 'Directory'),
  { name: 'TypeError', message: 'Directory must be a string. Received type undefined (undefined)' }
);
assert.doesNotThrow(() => validateString('/tmp', 'Directory'));

// 4. Verify C native addon binding and libuv integration
assert.ok(
  bindingC.includes('bare_os_chdir(js_env_t *env, js_callback_info_t *info)'),
  'binding.c must implement bare_os_chdir callback'
);
assert.ok(
  bindingC.includes('js_get_value_string_utf8(env, argv[0], dir, 4096, NULL)'),
  'bare_os_chdir must extract utf8 directory string up to 4096 bytes'
);
assert.ok(
  bindingC.includes('uv_chdir((char *) dir)'),
  'bare_os_chdir must invoke uv_chdir with target directory'
);
assert.ok(
  bindingC.includes('js_throw_error(env, uv_err_name(err), uv_strerror(err))'),
  'bare_os_chdir must throw libuv error on failure'
);
assert.ok(
  bindingC.includes('V("chdir", bare_os_chdir)'),
  'binding.c must register chdir in addon exports table'
);
assert.ok(
  bindingJs.includes('module.exports = require.addon()'),
  'binding.js must load native addon via require.addon()'
);

// 5. Verify CMake build specification and multi-platform prebuild artifacts
assert.ok(fs.existsSync(path.join(pkgDir, 'CMakeLists.txt')), 'CMakeLists.txt must exist');

const prebuildsDir = path.join(pkgDir, 'prebuilds');
const expectedTargets = [
  'linux-x64',
  'linux-arm64',
  'darwin-x64',
  'darwin-arm64',
  'win32-x64',
  'win32-arm64',
  'android-arm64',
  'ios-arm64'
];

for (const target of expectedTargets) {
  const prebuildPath = path.join(prebuildsDir, target, 'bare-os.bare');
  assert.ok(fs.existsSync(prebuildPath), `Prebuild binary for ${target} must exist at ${prebuildPath}`);
  const stats = fs.statSync(prebuildPath);
  assert.ok(stats.size > 0, `Prebuild binary for ${target} must not be empty`);
}

console.log('Contract passed: chdir in pkg:npm/bare-os@3.9.3 successfully verified');