hacklab 0.7.5 → 0.9.0

package/dist/index.js

@@ -1,149 +1,24 @@
 #!/usr/bin/env node
-import { createRequire } from 'node:module';
-import { clearSyncPaused, readSyncPaused } from './daily-sync.js';
-import { posthog } from './posthog.js';
-import { COMMANDS, findCommand } from './registry.js';
-import { resolveCommand } from './resolve-command.js';
-import { HACKLAB_ENVIRONMENTS, loadSession, resolveHacklabEnv, } from './session.js';
-import { banner, bold, dim } from './ui.js';
-import { notifyIfOutdated } from './utils/updateCheck.js';
-// Single source of the published version: read it from package.json (one level
-// up from this module in both `dist/` and `src/`) instead of hardcoding a string
-// that silently drifts from the real package version. `createRequire` resolves
-// JSON the same way under tsx (dev) and the compiled bin.
-const require = createRequire(import.meta.url);
-const { version: VERSION } = require('../package.json');
-/**
- * The global flags, each mapping onto the env var the rest of the CLI already
- * reads. Going through the env is what makes precedence fall out for free: the
- * flag overwrites any inherited value, and the readers (getAppUrl,
- * resolveCursorAuth) prefer the env over the config file. It also means a value
- * passed once on the command line reaches anything the command shells out to.
- */
-const GLOBAL_FLAGS = {
-    '--env': (value) => {
-        const env = resolveHacklabEnv(value);
-        if (!env) {
-            console.error(`--env must be one of: ${Object.keys(HACKLAB_ENVIRONMENTS).join(', ')} (abbreviations like dev/prod/stag work)`);
-            process.exit(1);
-        }
-        process.env.HACKLAB_APP_URL = HACKLAB_ENVIRONMENTS[env];
-    },
-    '--cursor-api-key': (value) => {
-        process.env.CURSOR_API_KEY = value;
-    },
-    '--cursor-email': (value) => {
-        process.env.CURSOR_EMAIL = value;
-    },
-};
-/**
- * Pull the global flags out of argv and apply them, returning the remaining args
- * so per-command parsing never sees them. Both `--flag value` and `--flag=value`
- * spellings work.
- */
-function applyGlobalFlags(argv) {
-    const rest = [];
-    for (let i = 0; i < argv.length; i++) {
-        const arg = argv[i];
-        const eq = arg.indexOf('=');
-        const name = eq === -1 ? arg : arg.slice(0, eq);
-        const apply = GLOBAL_FLAGS[name];
-        if (!apply) {
-            rest.push(arg);
-            continue;
-        }
-        const value = eq === -1 ? argv[++i] : arg.slice(eq + 1);
-        if (!value) {
-            console.error(`${name} requires a value`);
-            process.exit(1);
-        }
-        apply(value);
-    }
-    return rest;
-}
-const [cmd, ...args] = applyGlobalFlags(process.argv.slice(2));
-function printHelp() {
-    banner();
-    console.log('');
-    console.log(bold('usage:'));
-    // Align the descriptions: pad to the widest `name + args` so the summaries
-    // line up no matter how the registry grows.
-    const rows = COMMANDS.map((c) => ({
-        label: c.args ? `${c.name} ${c.args}` : c.name,
-        summary: c.summary,
-    }));
-    const width = Math.max(...rows.map((r) => r.label.length));
-    for (const { label, summary } of rows) {
-        console.log(`  hacklab ${dim(label)}${' '.repeat(width - label.length)}  ${summary}`);
-    }
-    console.log('');
-    console.log(`  ${dim('--env')} ${dim('<production|staging|development>')}  pick the backend (default: production)`);
-    console.log(`  ${dim('--cursor-api-key')} ${dim('<key>')}                  exact Cursor usage (or ${dim('CURSOR_API_KEY')})`);
-    console.log(`  ${dim('--cursor-email')} ${dim('<email>')}                  scope a Cursor team key to you (or ${dim('CURSOR_EMAIL')})`);
-    console.log('');
-}
-// Node-version guard (T9). The CLI uses modern Node APIs (global fetch,
-// AbortSignal.timeout). Fail fast with a clear message instead of a cryptic
-// runtime error on an old runtime. The nvm hint matters because a piped
-// `curl | sh` install runs in a non-interactive shell where nvm isn't sourced,
-// so version-manager users are told to run npx directly in their own shell.
-function enforceNodeVersion() {
-    const major = Number(process.versions.node.split('.')[0]);
-    if (Number.isFinite(major) && major < 20) {
-        console.error(`hacklab requires Node 20 or newer (you have ${process.versions.node}).`);
-        console.error('Using a version manager (nvm/fnm/volta)? Activate Node 20+ in your shell, then: npm install -g hacklab@latest');
-        process.exit(1);
-    }
-}
-async function main() {
-    enforceNodeVersion();
-    // Bare `hacklab` (no command) prints help, same as `--help`/`-h`. Runs before
-    // the update nudge so it reads as plain help, matching the `--help` path.
-    if (!cmd || cmd === '--help' || cmd === '-h') {
-        printHelp();
-        process.exit(0);
-    }
-    if (cmd === '--version' || cmd === '-v') {
-        console.log(VERSION);
-        process.exit(0);
-    }
-    // One-line nudge if a newer hacklab is published (interactive only, cached
-    // daily, timeout-guarded). Must run before any command output so it reads as
-    // a header, not buried in results.
-    await notifyIfOutdated(VERSION);
-    // Resolve a possibly-abbreviated command to its full name (e.g. `sy` -> sync,
-    // `or` -> org). Exact matches always win; an ambiguous prefix is
-    // rejected with the candidates so the user can disambiguate.
-    const resolution = resolveCommand(cmd);
-    if (resolution.kind === 'ambiguous') {
-        console.error(`ambiguous command "${cmd}": ${resolution.matches.join(' or ')}?`);
-        process.exit(1);
-    }
-    const command = resolution.kind === 'match' ? findCommand(resolution.name) : undefined;
-    if (!command) {
-        console.error(`unknown command: ${cmd}`);
-        console.error('run hacklab --help for usage');
-        process.exit(1);
-    }
-    // Surface a paused daily background sync (e.g. the session expired while the
-    // machine was off) once, then clear the marker. Skipped for the auth commands
-    // that fix it (login/join), so we never nag mid-fix.
-    if (process.stdout.isTTY &&
-        command.name !== 'login' &&
-        command.name !== 'join') {
-        const paused = await readSyncPaused();
-        if (paused) {
-            console.error(dim(`paused: daily background sync — ${paused}`));
-            await clearSyncPaused();
-        }
-    }
-    await command.run(args);
+// Minimal launcher. It checks the Node version using ONLY built-ins, then
+// dynamically imports the real CLI — so nothing that needs a Node 20+ API is
+// even *linked* until the guard passes. The real entry (cli.ts) pulls in
+// @clack/core, which statically imports `styleText` from node:util (Node 20.12+);
+// on Node 18 that fails to link with a cryptic SyntaxError *before* any code
+// runs, so the version check has to happen here, ahead of that import graph.
+//
+// npm only warns (doesn't block) on an `engines` mismatch, and version-manager
+// users can switch to an old Node after installing — so this runtime guard is
+// the real gate, not package.json.
+const major = Number(process.versions.node.split('.')[0]);
+if (Number.isFinite(major) && major < 20) {
+    console.error(`hacklab requires Node 20 or newer (you have ${process.versions.node}).`);
+    console.error('Using a version manager (nvm/fnm/volta)? Activate Node 20+ in your shell, then: npm install -g hacklab@latest');
+    process.exit(1);
 }
-main().catch(async (err) => {
+// Defer the real CLI (and its Node 20+ import graph) until after the guard.
+import('./cli.js').catch((err) => {
     console.error(err instanceof Error ? err.message : String(err));
-    const session = await loadSession().catch(() => null);
-    posthog.captureException(err, session?.handle);
-    await posthog.flush();
     process.exit(1);
 });
+export {};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,0EAA0E;AAC1E,6EAA6E;AAC7E,yEAAyE;AACzE,kFAAkF;AAClF,6EAA6E;AAC7E,6EAA6E;AAC7E,EAAE;AACF,+EAA+E;AAC/E,8EAA8E;AAC9E,mCAAmC;AAEnC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACzD,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;IACzC,OAAO,CAAC,KAAK,CACX,+CAA+C,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,CACzE,CAAA;IACD,OAAO,CAAC,KAAK,CACX,+GAA+G,CAChH,CAAA;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IACxC,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;IAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/machine.d.ts

@@ -0,0 +1,15 @@
+export declare function getMachinePath(): string;
+export type MachineIdentity = {
+    machineId: string;
+    /** Best-effort hostname for a friendlier "synced from N machines" UI later. */
+    machineName: string;
+};
+/**
+ * Load this machine's id, generating and persisting one on first use. Uses an
+ * exclusive create so two concurrent syncs (e.g. the daily daemon racing an
+ * interactive run) can't each mint a different id — the loser reads back the
+ * winner's file. Falls back to an ephemeral id only if the file can't be
+ * written at all, so sync never hard-fails on a read-only home directory.
+ */
+export declare function getMachineIdentity(): Promise<MachineIdentity>;
+//# sourceMappingURL=machine.d.ts.map

package/dist/machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine.d.ts","sourceRoot":"","sources":["../src/machine.ts"],"names":[],"mappings":"AAoBA,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAyBD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC,CAoBnE"}

package/dist/machine.js

@@ -0,0 +1,64 @@
+import { randomUUID } from 'node:crypto';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { homedir, hostname } from 'node:os';
+import { dirname, join } from 'node:path';
+/**
+ * Stable per-machine identity for token sync.
+ *
+ * The backend sums token usage across a user's machines and needs each machine
+ * to be distinguishable so a re-run from one machine is idempotent (it replaces
+ * that machine's contribution) while a second machine adds on top. We identify a
+ * machine with a random id generated once and persisted here.
+ *
+ * The id is deliberately env-independent — a machine is one machine whether you
+ * `hacklab sync --env prod` or `--env dev`; each backend tracks that same id in
+ * its own database. So this lives next to the session, not per-backend.
+ */
+const MACHINE_PATH = join(homedir(), '.hacklab', 'machine.json');
+export function getMachinePath() {
+    return process.env.HACKLAB_MACHINE_PATH ?? MACHINE_PATH;
+}
+function isValid(data) {
+    return (typeof data === 'object' &&
+        data !== null &&
+        typeof data.machineId === 'string' &&
+        data.machineId.length > 0);
+}
+async function readMachineId(path) {
+    try {
+        const parsed = JSON.parse(await readFile(path, 'utf8'));
+        return isValid(parsed) ? parsed.machineId : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Load this machine's id, generating and persisting one on first use. Uses an
+ * exclusive create so two concurrent syncs (e.g. the daily daemon racing an
+ * interactive run) can't each mint a different id — the loser reads back the
+ * winner's file. Falls back to an ephemeral id only if the file can't be
+ * written at all, so sync never hard-fails on a read-only home directory.
+ */
+export async function getMachineIdentity() {
+    const path = getMachinePath();
+    const existing = await readMachineId(path);
+    if (existing)
+        return { machineId: existing, machineName: hostname() };
+    const machineId = randomUUID();
+    const body = `${JSON.stringify({ machineId, createdAt: new Date().toISOString() }, null, 2)}\n`;
+    try {
+        await mkdir(dirname(path), { recursive: true });
+        // 'wx' fails if another process created it first; re-read to adopt theirs.
+        await writeFile(path, body, { encoding: 'utf8', flag: 'wx' });
+        return { machineId, machineName: hostname() };
+    }
+    catch {
+        const raced = await readMachineId(path);
+        return {
+            machineId: raced ?? machineId,
+            machineName: hostname(),
+        };
+    }
+}
+//# sourceMappingURL=machine.js.map

package/dist/machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine.js","sourceRoot":"","sources":["../src/machine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC7D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAC3C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEzC;;;;;;;;;;;GAWG;AAEH,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,cAAc,CAAC,CAAA;AAEhE,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,YAAY,CAAA;AACzD,CAAC;AAaD,SAAS,OAAO,CAAC,IAAa;IAC5B,OAAO,CACL,OAAO,IAAI,KAAK,QAAQ;QACxB,IAAI,KAAK,IAAI;QACb,OAAQ,IAAgC,CAAC,SAAS,KAAK,QAAQ;QAC9D,IAA8B,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CACrD,CAAA;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,IAAY;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAY,CAAA;QAClE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAA;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,IAAI,GAAG,cAAc,EAAE,CAAA;IAE7B,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAA;IAC1C,IAAI,QAAQ;QAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,CAAA;IAErE,MAAM,SAAS,GAAG,UAAU,EAAE,CAAA;IAC9B,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAwB,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAA;IACrH,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC/C,2EAA2E;QAC3E,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QAC7D,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,CAAA;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAA;QACvC,OAAO;YACL,SAAS,EAAE,KAAK,IAAI,SAAS;YAC7B,WAAW,EAAE,QAAQ,EAAE;SACxB,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/org-fields.d.ts

@@ -0,0 +1,57 @@
+export type OrgFieldType = 'text' | 'url' | 'number' | 'boolean' | 'list';
+export type OrgFieldSpec = {
+    /** API key sent to /api/cli/org. */
+    key: string;
+    /** CLI-facing name (`hacklab org set <name> …`). */
+    name: string;
+    /** Label shown in the interactive editor. */
+    label: string;
+    type: OrgFieldType;
+};
+export declare const ORG_FIELDS: OrgFieldSpec[];
+export declare const ORG_FIELD_NAMES: string[];
+export type OrgValue = string | number | boolean | string[] | null;
+export type NormalizedOrgValue = {
+    ok: true;
+    value: OrgValue;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Shape one raw CLI string into the value the API expects. Empty clears the
+ * field (except name/slug, which are required). URLs get https:// prepended
+ * when the scheme is missing; lists split on commas. Real validation (slug
+ * pattern, lengths, URL syntax) stays server-side.
+ */
+export declare function normalizeOrgFieldValue(spec: OrgFieldSpec, raw: string): NormalizedOrgValue;
+/**
+ * Map a parsed yaml/json document to API fields for `org apply`. Keys may be
+ * CLI names (`long-description`, `hiring`) or API keys (`longDescription`,
+ * `isHiring`); unknown keys fail loudly so a typo can't silently drop a field.
+ * Lists accept real arrays or comma-separated strings.
+ */
+export declare function parseOrgDocument(doc: unknown): {
+    ok: true;
+    fields: Record<string, OrgValue>;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Pick the org a view/set/apply targets. `--org <slug>` wins; with no flag,
+ * exactly one managed org is the target, zero or several is a typed error the
+ * caller renders (JSON gets the code, humans get the message — which always
+ * names the way out).
+ */
+export declare function resolveTargetOrg<T extends {
+    slug: string;
+}>(organizations: T[], slugFlag: string | undefined): {
+    ok: true;
+    org: T;
+} | {
+    ok: false;
+    code: 'no_org' | 'ambiguous_org' | 'not_found';
+    error: string;
+};
+//# sourceMappingURL=org-fields.d.ts.map

package/dist/org-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-fields.d.ts","sourceRoot":"","sources":["../src/org-fields.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAA;AAEzE,MAAM,MAAM,YAAY,GAAG;IACzB,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAA;IACX,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAA;IACZ,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,YAAY,CAAA;CACnB,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,YAAY,EA4BpC,CAAA;AAED,eAAO,MAAM,eAAe,UAAgC,CAAA;AAK5D,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,IAAI,CAAA;AAElE,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,GAC7B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAShC;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,YAAY,EAClB,GAAG,EAAE,MAAM,GACV,kBAAkB,CA+BpB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GACzC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;CAAE,GAC9C;IACE,EAAE,EAAE,KAAK,CAAA;IACT,KAAK,EAAE,MAAM,CAAA;CACd,CAqDJ;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EACzD,aAAa,EAAE,CAAC,EAAE,EAClB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAE1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,CAAC,CAAA;CAAE,GACpB;IACE,EAAE,EAAE,KAAK,CAAA;IACT,IAAI,EAAE,QAAQ,GAAG,eAAe,GAAG,WAAW,CAAA;IAC9C,KAAK,EAAE,MAAM,CAAA;CACd,CA+BJ"}

package/dist/org-fields.js

@@ -0,0 +1,167 @@
+import { ensureScheme, FALSE_WORDS, TRUE_WORDS } from './field-normalize.js';
+export const ORG_FIELDS = [
+    { key: 'name', name: 'name', label: 'Name', type: 'text' },
+    { key: 'slug', name: 'slug', label: 'Slug (URL handle)', type: 'text' },
+    { key: 'logoUrl', name: 'logo', label: 'Logo URL', type: 'url' },
+    { key: 'website', name: 'website', label: 'Website', type: 'url' },
+    {
+        key: 'description',
+        name: 'description',
+        label: 'Short description',
+        type: 'text',
+    },
+    {
+        key: 'longDescription',
+        name: 'long-description',
+        label: 'Long description',
+        type: 'text',
+    },
+    { key: 'ycBatch', name: 'yc-batch', label: 'YC batch', type: 'text' },
+    { key: 'ycSlug', name: 'yc-slug', label: 'YC slug', type: 'text' },
+    { key: 'ycUrl', name: 'yc-url', label: 'YC URL', type: 'url' },
+    { key: 'waasUrl', name: 'waas', label: 'WaaS URL', type: 'url' },
+    { key: 'teamSize', name: 'team-size', label: 'Team size', type: 'number' },
+    { key: 'status', name: 'status', label: 'Status', type: 'text' },
+    { key: 'stage', name: 'stage', label: 'Stage', type: 'text' },
+    { key: 'isHiring', name: 'hiring', label: 'Hiring?', type: 'boolean' },
+    { key: 'industries', name: 'industries', label: 'Industries', type: 'list' },
+    { key: 'tags', name: 'tags', label: 'Tags', type: 'list' },
+    { key: 'locations', name: 'locations', label: 'Locations', type: 'list' },
+];
+export const ORG_FIELD_NAMES = ORG_FIELDS.map((f) => f.name);
+// name and slug are notNull columns — a blank must fail loudly, not clear.
+const REQUIRED_KEYS = new Set(['name', 'slug']);
+function splitList(raw) {
+    return raw
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+/**
+ * Shape one raw CLI string into the value the API expects. Empty clears the
+ * field (except name/slug, which are required). URLs get https:// prepended
+ * when the scheme is missing; lists split on commas. Real validation (slug
+ * pattern, lengths, URL syntax) stays server-side.
+ */
+export function normalizeOrgFieldValue(spec, raw) {
+    const trimmed = raw.trim();
+    if (!trimmed) {
+        if (REQUIRED_KEYS.has(spec.key)) {
+            return { ok: false, error: `${spec.name} can't be empty` };
+        }
+        return { ok: true, value: null };
+    }
+    if (spec.type === 'boolean') {
+        const word = trimmed.toLowerCase();
+        if (TRUE_WORDS.has(word))
+            return { ok: true, value: true };
+        if (FALSE_WORDS.has(word))
+            return { ok: true, value: false };
+        return { ok: false, error: `${spec.name} must be yes or no` };
+    }
+    if (spec.type === 'number') {
+        if (!/^\d+$/.test(trimmed)) {
+            return { ok: false, error: `${spec.name} must be a whole number` };
+        }
+        return { ok: true, value: Number(trimmed) };
+    }
+    if (spec.type === 'list') {
+        const items = splitList(trimmed);
+        return { ok: true, value: items.length ? items : null };
+    }
+    if (spec.type === 'url')
+        return { ok: true, value: ensureScheme(trimmed) };
+    return { ok: true, value: trimmed };
+}
+/**
+ * Map a parsed yaml/json document to API fields for `org apply`. Keys may be
+ * CLI names (`long-description`, `hiring`) or API keys (`longDescription`,
+ * `isHiring`); unknown keys fail loudly so a typo can't silently drop a field.
+ * Lists accept real arrays or comma-separated strings.
+ */
+export function parseOrgDocument(doc) {
+    if (typeof doc !== 'object' || doc === null || Array.isArray(doc)) {
+        return { ok: false, error: 'expected a mapping of fields to values' };
+    }
+    const fields = {};
+    for (const [rawKey, rawValue] of Object.entries(doc)) {
+        const spec = ORG_FIELDS.find((f) => f.name === rawKey || f.key === rawKey);
+        if (!spec) {
+            return {
+                ok: false,
+                error: `unknown field "${rawKey}" (fields: ${ORG_FIELD_NAMES.join(', ')})`,
+            };
+        }
+        if (rawValue === null) {
+            if (REQUIRED_KEYS.has(spec.key)) {
+                return { ok: false, error: `${spec.name} can't be empty` };
+            }
+            fields[spec.key] = null;
+            continue;
+        }
+        if (typeof rawValue === 'boolean') {
+            if (spec.type !== 'boolean') {
+                return { ok: false, error: `${spec.name}: expected a string value` };
+            }
+            fields[spec.key] = rawValue;
+            continue;
+        }
+        if (Array.isArray(rawValue)) {
+            if (spec.type !== 'list') {
+                return { ok: false, error: `${spec.name}: expected a single value` };
+            }
+            const items = rawValue.map((v) => String(v).trim()).filter(Boolean);
+            fields[spec.key] = items.length ? items : null;
+            continue;
+        }
+        if (typeof rawValue !== 'string' && typeof rawValue !== 'number') {
+            return { ok: false, error: `${spec.name}: expected a string value` };
+        }
+        const normalized = normalizeOrgFieldValue(spec, String(rawValue));
+        if (!normalized.ok)
+            return normalized;
+        fields[spec.key] = normalized.value;
+    }
+    if (Object.keys(fields).length === 0) {
+        return { ok: false, error: 'no fields to apply' };
+    }
+    return { ok: true, fields };
+}
+/**
+ * Pick the org a view/set/apply targets. `--org <slug>` wins; with no flag,
+ * exactly one managed org is the target, zero or several is a typed error the
+ * caller renders (JSON gets the code, humans get the message — which always
+ * names the way out).
+ */
+export function resolveTargetOrg(organizations, slugFlag) {
+    if (slugFlag) {
+        const found = organizations.find((o) => o.slug === slugFlag);
+        if (found)
+            return { ok: true, org: found };
+        const yours = organizations.map((o) => o.slug).join(', ');
+        return {
+            ok: false,
+            code: 'not_found',
+            error: organizations.length
+                ? `you don't manage "${slugFlag}" (you manage: ${yours})`
+                : `you don't manage "${slugFlag}" — claim or create it first`,
+        };
+    }
+    if (organizations.length === 0) {
+        return {
+            ok: false,
+            code: 'no_org',
+            error: "you don't manage a company yet — run `hacklab org claim <slug>` or `hacklab org create`",
+        };
+    }
+    if (organizations.length > 1) {
+        const slugs = organizations.map((o) => o.slug).join(', ');
+        return {
+            ok: false,
+            code: 'ambiguous_org',
+            error: `you manage ${organizations.length} companies — pass --org <slug> (${slugs})`,
+        };
+    }
+    return { ok: true, org: organizations[0] };
+}
+//# sourceMappingURL=org-fields.js.map

package/dist/org-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-fields.js","sourceRoot":"","sources":["../src/org-fields.ts"],"names":[],"mappings":"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"}

package/dist/posthog.d.ts

@@ -1,9 +1,38 @@
-import { PostHog } from 'posthog-node';
-export declare const posthog: PostHog;
 /**
- * Capture an event and immediately flush it to PostHog. Since the CLI is a
- * short-lived process, flushing after every capture ensures the event is sent
- * before the process exits. No-ops silently if distinctId is absent.
+ * Telemetry is opt-OUT. It's off when the user sets `HACKLAB_NO_TELEMETRY`
+ * (mirrors `HACKLAB_NO_UPDATE_CHECK`) or the cross-tool `DO_NOT_TRACK` standard
+ * (https://consoledonottrack.com). Checked at every entry point, so a disabled
+ * CLI never constructs a client, phones home, or installs exception handlers.
+ */
+export declare function isTelemetryDisabled(): boolean;
+/**
+ * Capture an event and flush it. Falls back to the anonymous device id when no
+ * handle is given, so pre-auth usage is still counted (and later stitched onto
+ * the user via `identifyUser`). Fire-and-forget: gated on opt-out, wrapped so it
+ * can never slow down or break the command that called it.
  */
 export declare function captureEvent(distinctId: string | undefined, event: string, properties?: Record<string, unknown>): Promise<void>;
+/**
+ * Identify the logged-in user and merge any anonymous pre-login history onto
+ * them. `properties` is passed straight through (callers set `$set` /
+ * `$set_once`). Opt-out gated and fully wrapped.
+ */
+export declare function identifyUser(handle: string, properties: Record<string, unknown>): Promise<void>;
+/** Report an unhandled error to PostHog. Opt-out gated and wrapped. */
+export declare function captureException(error: unknown, distinctId?: string): Promise<void>;
+/**
+ * Final drain before the process exits. No-op if telemetry never initialized.
+ * Uses flush(), not shutdown(): shutdown() routes a failed flush to a hardcoded
+ * console.error (a network stack trace in the user's terminal), whereas flush()
+ * rejects into our own catch and stays silent. There are no background timers to
+ * clear (flushInterval is 0), so flush() is a complete drain here.
+ */
+export declare function shutdownTelemetry(): Promise<void>;
+/**
+ * One-time, one-line notice that the CLI collects anonymous usage, with the
+ * opt-out. Interactive only (never in pipes / CI / the quiet daily run), shown
+ * once per machine (flagged in telemetry.json). Mirrors the update-check nudge:
+ * stderr, TTY-gated, and wrapped so it can never break or delay a command.
+ */
+export declare function maybePrintTelemetryNotice(): Promise<void>;
 //# sourceMappingURL=posthog.d.ts.map

package/dist/posthog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"posthog.d.ts","sourceRoot":"","sources":["../src/posthog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,eAAO,MAAM,OAAO,SASnB,CAAA;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,OAAO,CAAC,IAAI,CAAC,CAIf"}
+{"version":3,"file":"posthog.d.ts","sourceRoot":"","sources":["../src/posthog.ts"],"names":[],"mappings":"AAkCA;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAI7C;AAgGD;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,uEAAuE;AACvE,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,OAAO,EACd,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAOvD;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC,CAmB/D"}