Generates a stable, deterministic workspace identifier from the absolute path of a project root using SHA-256(workspaceRoot).slice(0, 12). The same directory always produces the same ID — no state files, no random seeds.

Install

npm install @vreko/workspace-identity

Usage

import { getWorkspaceId } from '@vreko/workspace-identity';

const id = getWorkspaceId('/Users/alice/projects/my-app');
// → "a3f8c21b90d4" (12-char hex, stable across machines for the same path)

The ID scopes learnings, sessions, and intelligence to a specific project directory. Two checkouts of the same repo at different paths produce different IDs by design.

License

Apache-2.0