This repository publishes the ortelic package to the public npm registry. Its job is to hold the name for Ortelic until there is a JavaScript SDK to put under it.

It is a placeholder, but not an empty one. npm's dispute policy exists precisely to reclaim names held by packages that do nothing, so this one ships a working CLI and a small typed API, states plainly what it is, and points at ortelic.com. Nothing here is proprietary and no private repository is named — the npm package is public.

Use

npx ortelic

  ORTELIC — Spatial Intelligence

  The npm package `ortelic` (v0.0.1) reserves this name for
  Ortelic. It is a namespace anchor, not a library — there is no
  API to build against yet.

  https://www.ortelic.com

| Flag | Effect | | --- | --- | | (none) | Print the banner | | -j, --json | Print the metadata as JSON | | -v, --version | Print the version | | -h, --help | Print the usage |

Anything else exits 1 with the usage on stderr.

API

ESM only, Node ≥ 20, zero dependencies — runtime and development both. Types ship hand-written in index.d.ts; there is no build step.

import { info, banner, status, version } from 'ortelic'

info()
// {
//   name: 'ortelic',
//   version: '0.0.1',
//   org: 'Ortelic',
//   tagline: 'Spatial Intelligence',
//   homepage: 'https://www.ortelic.com',
//   status: 'reserved'
// }

status  // 'reserved' until a real SDK ships under this name

version is read from package.json at runtime, so the two can never drift.

Layout

| Path | Role | | --- | --- | | src/index.js | The data and the two pure functions — info(), banner() | | src/run.js | Argument handling, stdio injected so it is testable | | src/cli.js | The bin shim: process.argv in, process.exitCode out | | index.d.ts | Hand-written types | | test/ | node:test, no runner to install |

Develop

npm test          # node --test
npm start         # run the CLI from source

Release

Publishing is manual and deliberate — this name should move rarely.

npm version patch          # or minor / major; tags the commit
git push --follow-tags
npm publish --dry-run      # inspect the tarball first
npm publish                # requires npm login as an `ortelic` owner

prepublishOnly runs the test suite, so a broken tree cannot be published. The files allowlist in package.json keeps the tarball to src/, index.d.ts, README.md and LICENSE.

Unpublishing is only possible within 72 hours, and a name unpublished after that stays burned. Check npm publish --dry-run output before the real thing.

When the name goes live

Replace this package's contents with the real SDK, flip status to 'active', and cut a 1.0.0. The 0.0.x line is deliberately below any version anyone would depend on by accident.

License

MIT — see LICENSE. Deliberately permissive: this is a public npm package containing nothing proprietary, and a restrictive licence on a package people are meant to be able to install is a contradiction. The rest of the Ortelic estate keeps its own licensing.