@telora/daemon 0.21.98 → 0.21.144

package/dist/cli/connect/registration.js

@@ -0,0 +1,207 @@
+/**
+ * Connected-workstation identity + AI-tracking registration.
+ *
+ * Reads the connected identity from ~/.telora/daemon.json, locates the
+ * telora-ai CLI, pre-populates its config, and merges the tracking hooks into
+ * ~/.claude/settings.json. Split out of cli/connect.ts (file-size limit) into
+ * the connect/* family; connect.ts re-exports these so existing importers keep
+ * resolving them from cli/connect.js. Leaf module: connect.ts -> connect/registration.ts.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { spawnSync } from 'node:child_process';
+import { resolve, delimiter } from 'node:path';
+import { homedir } from 'node:os';
+import { cliLog as log } from '../../shell/log.js';
+/**
+ * Look up an existing product entry in `~/.telora/daemon.json` whose
+ * repoPath matches the given path. Returns the product id when found,
+ * else null. Used by runConnect for re-run idempotency: a second run on
+ * the same dir reuses the existing binding instead of creating a duplicate
+ * product on the unbound path.
+ */
+export function findExistingProductForRepo(repoPath) {
+    const configPath = resolve(homedir(), '.telora', 'daemon.json');
+    if (!existsSync(configPath))
+        return null;
+    try {
+        const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+        const target = resolve(repoPath);
+        for (const entry of config.products ?? []) {
+            if (entry.repoPath && resolve(entry.repoPath) === target && entry.id) {
+                return entry.id;
+            }
+        }
+    }
+    catch (err) {
+        // Malformed config -- treat as no match; runConnect overwrites it anyway.
+        log.debug('Malformed config -- treat as no match; runConnect overwrites it anyway', { error: String(err?.message ?? err) });
+    }
+    return null;
+}
+/**
+ * Resolve the connected-workstation identity for `repoPath` from
+ * `~/.telora/daemon.json`: the top-level `teloraUrl` / `organizationId` plus the
+ * `products[]` entry whose `repoPath` matches. Returns null when there is no
+ * config, the config lacks url/org, or no product entry binds this repo -- i.e.
+ * the repo is not connected, so `harness add` must direct the operator to
+ * `connect` first.
+ */
+export function readConnectedIdentity(repoPath) {
+    const configPath = resolve(homedir(), '.telora', 'daemon.json');
+    if (!existsSync(configPath))
+        return null;
+    try {
+        const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+        if (!config.teloraUrl || !config.organizationId)
+            return null;
+        const target = resolve(repoPath);
+        for (const entry of config.products ?? []) {
+            if (entry.repoPath && resolve(entry.repoPath) === target && entry.id) {
+                return {
+                    teloraUrl: config.teloraUrl,
+                    organizationId: config.organizationId,
+                    productId: entry.id,
+                };
+            }
+        }
+    }
+    catch {
+        // Malformed config -- treat as not-connected.
+        return null;
+    }
+    return null;
+}
+// ── Workstation tracking (D4): telora-ai detection + hook merge ─────────
+/**
+ * Locate the `telora-ai` Python CLI on PATH. Returns the absolute path if
+ * found, else null. Detection is the entire install model -- if the user
+ * doesn't have it, connect prints a remediation hint and continues
+ * (tracking is opt-in).
+ */
+export function locateTeloraAi() {
+    const path = process.env.PATH ?? '';
+    const entries = path.split(delimiter).filter(Boolean);
+    for (const entry of entries) {
+        const candidate = resolve(entry, 'telora-ai');
+        if (existsSync(candidate))
+            return candidate;
+    }
+    return null;
+}
+/**
+ * Pre-populate the user's `~/.syntelyos/ai_tracking.db` config table with
+ * the redeem-derived credentials. Skips the
+ * `telora-ai register <code>` round-trip that Settings > AI Trackers
+ * normally requires -- the tracker row already exists in Telora (the
+ * redeem RPC inserted it), so all we need is to point the local DB at
+ * it.
+ *
+ * Each `telora-ai config <key> <value>` call is a single sqlite UPSERT;
+ * idempotent on re-runs.
+ *
+ * Returns true on success, false if any sub-call failed (the failure is
+ * surfaced via io.err but never aborts the connect flow).
+ */
+export function registerWorkstationLocally(params) {
+    const entries = [
+        ['telora_url', params.teloraUrl],
+        ['tracker_id', params.trackerId],
+        // The python tool's data model treats access_token and tracker_id as
+        // separate fields, but in our model the tracker_id IS the bearer
+        // token. Setting both keeps cmd_status / cmd_sync happy.
+        ['access_token', params.trackerId],
+        ['org_id', params.organizationId],
+    ];
+    for (const [key, value] of entries) {
+        const result = spawnSync(params.teloraAiPath, ['config', key, value], {
+            stdio: 'pipe',
+            encoding: 'utf-8',
+        });
+        if (result.status !== 0) {
+            params.io.err(`Warning: workstation registration step '${key}' failed (${result.status ?? 'no exit'}): ${result.stderr ?? result.stdout ?? ''}\n`);
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Idempotent merge of `PostToolUse` and `UserPromptSubmit` hook entries
+ * into `~/.claude/settings.json`. Mirrors the shape of `telora-ai
+ * setup-hooks` in scripts/telora-ai but runs from the daemon connect flow
+ * so the user doesn't have to invoke it manually.
+ *
+ * Existing hook entries are preserved. Re-runs do not duplicate.
+ */
+export function mergeUserClaudeSettingsHooks(io, homeOverride) {
+    const home = homeOverride ?? homedir();
+    const settingsDir = resolve(home, '.claude');
+    const settingsPath = resolve(settingsDir, 'settings.json');
+    const hookBin = locateBinaryOnPath('telora-ai-hook');
+    const humanHookBin = locateBinaryOnPath('telora-ai-human-hook');
+    if (!hookBin || !humanHookBin) {
+        io.err(`Warning: telora-ai-hook / telora-ai-human-hook not on PATH. Skipping ~/.claude/settings.json merge.\n`);
+        return false;
+    }
+    if (!existsSync(settingsDir))
+        mkdirSync(settingsDir, { recursive: true });
+    let parsed = {};
+    if (existsSync(settingsPath)) {
+        try {
+            const raw = readFileSync(settingsPath, 'utf-8');
+            const candidate = JSON.parse(raw);
+            if (candidate && typeof candidate === 'object' && !Array.isArray(candidate)) {
+                parsed = candidate;
+            }
+        }
+        catch (err) {
+            io.err(`Warning: ${settingsPath} is not valid JSON; leaving it alone: ${err instanceof Error ? err.message : String(err)}\n`);
+            return false;
+        }
+    }
+    const hooks = typeof parsed.hooks === 'object' && parsed.hooks !== null
+        ? parsed.hooks
+        : {};
+    const desired = {
+        PostToolUse: {
+            matcher: '',
+            hooks: [{ type: 'command', command: hookBin }],
+        },
+        UserPromptSubmit: {
+            matcher: '',
+            hooks: [{ type: 'command', command: humanHookBin }],
+        },
+    };
+    for (const [eventName, entry] of Object.entries(desired)) {
+        const existing = hooks[eventName] ?? [];
+        let alreadyPresent = false;
+        for (const rule of existing) {
+            for (const h of rule.hooks ?? []) {
+                const cmd = h.command ?? '';
+                if (cmd.includes('telora-ai-hook') || cmd.includes('telora-ai-human-hook')) {
+                    alreadyPresent = true;
+                    // Refresh path in case the binary moved between runs.
+                    const desiredCmd = entry.hooks[0].command;
+                    if (cmd !== desiredCmd)
+                        h.command = desiredCmd;
+                }
+            }
+        }
+        if (!alreadyPresent)
+            existing.push(entry);
+        hooks[eventName] = existing;
+    }
+    parsed.hooks = hooks;
+    writeFileSync(settingsPath, JSON.stringify(parsed, null, 2) + '\n');
+    io.out(`Merged Telora tracking hooks into ${settingsPath}.\n`);
+    return true;
+}
+function locateBinaryOnPath(name) {
+    const path = process.env.PATH ?? '';
+    for (const entry of path.split(delimiter).filter(Boolean)) {
+        const candidate = resolve(entry, name);
+        if (existsSync(candidate))
+            return candidate;
+    }
+    return null;
+}
+//# sourceMappingURL=registration.js.map

package/dist/cli/connect/registration.js.map

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

package/dist/cli/connect.d.ts

@@ -21,6 +21,9 @@ export { renderClineRules, writeClineProjectRules, renderClineMcpSettings, write
 export { DEFAULT_IDE_HARNESS_PRELOAD, IDE_MCP_REGISTRATION_SENTENCE, IDE_MCP_CONFIG_PATH, renderIdeMcpConfig, writeIdeMcpConfig, writeIdeHarnessScaffolding, } from './connect/ide.js';
 export type { IdeHarness } from './connect/ide.js';
 export { harnessGitignoreEntries, writeHarnessScaffolding } from './connect/scaffolding.js';
+export { resolveCodexCliPath, writeConnectDaemonConfig, writeStarterPromptArtifacts, ensureGitignoreEntries, startDaemonOnDisk, } from './connect/config-write.js';
+export { findExistingProductForRepo, readConnectedIdentity, locateTeloraAi, registerWorkstationLocally, mergeUserClaudeSettingsHooks, } from './connect/registration.js';
+export type { ConnectedIdentity } from './connect/registration.js';
 /**
  * Production Telora API URL embedded in the published @telora/daemon package.
  * Override with TELORA_URL for local dev.
@@ -116,147 +119,6 @@ export declare function defaultIO(io?: Partial<ConnectIO>): ConnectIO;
  * Validate that the token has the expected `TOK_*` shape.
  */
 export declare function validateTokenShape(token: string): boolean;
-/**
- * Resolve Codex to a stable on-disk executable for daemon config.
- *
- * The daemon runs detached and may not inherit the operator's login-shell PATH.
- * Persisting an absolute path during `connect --harness codex` keeps future
- * agent spawns independent of shell startup files.
- */
-export declare function resolveCodexCliPath(repoPath: string): string | null;
-/**
- * Write the daemon config to ~/.telora/daemon.json.
- *
- * Connect-flow config is single-product. If a config already exists,
- * we overwrite it and print a warning -- re-running connect is the
- * supported recovery path.
- *
- * The `trackerId` is persisted in this file (mode 0600 in $HOME) so the
- * background daemon can read it on startup without an env var. This matches
- * the security profile of `.mcp.json`, which already stores the same secret.
- */
-export declare function writeConnectDaemonConfig(params: {
-    teloraUrl: string;
-    trackerId: string;
-    organizationId: string;
-    productId: string;
-    repoPath: string;
-    io: ConnectIO;
-    /** Absolute path of the per-product isolated CODEX_HOME (local-model flow). */
-    codexHome?: string;
-    /** Default coding engine for the product (local-model flow). */
-    defaultCodingEngine?: string;
-    /** Model id the local-model server exposes (local-model flow). */
-    codexModel?: string;
-    /** Absolute path to the Codex CLI for detached daemon spawns. */
-    codexPath?: string;
-}): string;
-/**
- * Write the AHA starter prompt + first-session marker into the repo's
- * `.telora/` directory. The bash bootstrap reads `starter-prompt.md` and
- * passes it to `claude` as the first user message.
- *
- * Returns the absolute path of the prompt file (or null on failure -- the
- * caller treats prompt injection as best-effort and falls back to plain
- * `claude` if this artifact is missing).
- */
-export declare function writeStarterPromptArtifacts(repoPath: string, io: ConnectIO): string | null;
-/**
- * Append `.telora/` and `.mcp.json` to .gitignore in the repo root if missing.
- *
- * `.mcp.json` is per-user-machine (absolute path to the daemon's bundled
- * MCP). It's regenerated by `connect` and refreshed by the daemon on every
- * startup, so collaborators don't need to share it.
- */
-export declare function ensureGitignoreEntries(repoPath: string, io: ConnectIO, extra?: readonly string[]): void;
-/**
- * Start the daemon as a detached background process from a stable on-disk
- * install -- never from an ephemeral npx cache (which cannot self-update).
- *
- * Resolution order:
- *   1. Use an existing on-disk binary (global install on PATH, or a repo-local
- *      `node_modules/.bin/telora-daemon` dev dependency).
- *   2. If none exists, run `npm install -g @telora/daemon` best-effort. Global
- *      install keeps the connect flow language-agnostic -- it leaves no
- *      `package.json`/`node_modules`/dev-dependency footprint in the user's
- *      repo (Rust/Python/Go/empty repos stay untouched).
- *   3. Spawn the resolved on-disk `telora-daemon run`.
- *
- * On install failure this throws (the caller surfaces the manual
- * `npm install -g @telora/daemon` instruction and skips auto-start); it does
- * NOT fall back to npx, because an npx-run daemon is exactly what this focus
- * retires.
- *
- * Bin name is explicit (`telora-daemon`) because the package's bins are
- * `telora-daemon` and `telora-daemon-wrapper`; neither matches the unscoped
- * package name `daemon`.
- */
-export declare function startDaemonOnDisk(repoPath: string): number;
-/**
- * Look up an existing product entry in `~/.telora/daemon.json` whose
- * repoPath matches the given path. Returns the product id when found,
- * else null. Used by runConnect for re-run idempotency: a second run on
- * the same dir reuses the existing binding instead of creating a duplicate
- * product on the unbound path.
- */
-export declare function findExistingProductForRepo(repoPath: string): string | null;
-/**
- * Workstation identity for an already-connected repo, resolved from the single
- * source `~/.telora/daemon.json`. Returned by `readConnectedIdentity` and
- * consumed by the token-free `harness add` verb -- which never re-redeems a
- * connect token, it just reads what `connect` already persisted.
- */
-export interface ConnectedIdentity {
-    teloraUrl: string;
-    organizationId: string;
-    productId: string;
-}
-/**
- * Resolve the connected-workstation identity for `repoPath` from
- * `~/.telora/daemon.json`: the top-level `teloraUrl` / `organizationId` plus the
- * `products[]` entry whose `repoPath` matches. Returns null when there is no
- * config, the config lacks url/org, or no product entry binds this repo -- i.e.
- * the repo is not connected, so `harness add` must direct the operator to
- * `connect` first.
- */
-export declare function readConnectedIdentity(repoPath: string): ConnectedIdentity | null;
-/**
- * Locate the `telora-ai` Python CLI on PATH. Returns the absolute path if
- * found, else null. Detection is the entire install model -- if the user
- * doesn't have it, connect prints a remediation hint and continues
- * (tracking is opt-in).
- */
-export declare function locateTeloraAi(): string | null;
-/**
- * Pre-populate the user's `~/.syntelyos/ai_tracking.db` config table with
- * the redeem-derived credentials. Skips the
- * `telora-ai register <code>` round-trip that Settings > AI Trackers
- * normally requires -- the tracker row already exists in Telora (the
- * redeem RPC inserted it), so all we need is to point the local DB at
- * it.
- *
- * Each `telora-ai config <key> <value>` call is a single sqlite UPSERT;
- * idempotent on re-runs.
- *
- * Returns true on success, false if any sub-call failed (the failure is
- * surfaced via io.err but never aborts the connect flow).
- */
-export declare function registerWorkstationLocally(params: {
-    teloraAiPath: string;
-    trackerId: string;
-    organizationId: string;
-    teloraUrl: string;
-    io: ConnectIO;
-}): boolean;
-/**
- * Idempotent merge of `PostToolUse` and `UserPromptSubmit` hook entries
- * into `~/.claude/settings.json`. Mirrors the shape of `telora-ai
- * setup-hooks` in scripts/telora-ai but runs from the daemon connect flow
- * so the user doesn't have to invoke it manually.
- *
- * Existing hook entries are preserved. Re-runs do not duplicate.
- */
-export declare function mergeUserClaudeSettingsHooks(io: ConnectIO, homeOverride?: string): boolean;
 /**
  * Write `.telora/.product-bootstrapped` -- a marker the starter prompt
  * detects on first turn to offer a rename of the basename-derived product

package/dist/cli/connect.d.ts.map

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