@temet/cli 0.3.2 → 0.3.3

package/dist/audit.js

@@ -459,7 +459,19 @@ export async function runAuditCommand(opts) {
         }
         resolvedPath = resolution.path;
     }
-    const sessionFiles = findSessionFiles(resolvedPath);
+    let sessionFiles = findSessionFiles(resolvedPath);
+    if (sessionFiles.length === 0 && !opts.path && !opts.quiet && !opts.json) {
+        const { findClaudeProjectCandidates } = await import("./lib/path-resolver.js");
+        const candidates = findClaudeProjectCandidates();
+        if (candidates.length > 0) {
+            const selected = await chooseSessionCandidate(candidates);
+            if (selected) {
+                resolvedPath = selected.sessionDir;
+                sessionFiles = findSessionFiles(resolvedPath);
+                process.stderr.write(`${dim(`[temet] using ${selected.label}`, process.stderr)}\n`);
+            }
+        }
+    }
     if (sessionFiles.length === 0) {
         if (!opts.quiet) {
             console.error(`[temet] no .jsonl session files found in ${resolvedPath}`);

package/dist/doctor.d.ts

@@ -0,0 +1,5 @@
+export type DoctorCliOptions = {
+    path?: string;
+    json: boolean;
+};
+export declare function runDoctorCommand(opts: DoctorCliOptions): Promise<void>;

package/dist/doctor.js

@@ -0,0 +1,79 @@
+import { existsSync } from "node:fs";
+import { basename } from "node:path";
+import { findClaudeProjectCandidates, resolveSessionPath, } from "./lib/path-resolver.js";
+import { getSettingsPath, isHookInstalled, readSettings } from "./lib/hook-installer.js";
+import { getMenubarAppPath, isMenubarInstalled } from "./lib/menubar-installer.js";
+import { getMenubarConfigPath, getMenubarStatePath, } from "./lib/menubar-state.js";
+import { resolveAuth } from "./lib/narrator-lite.js";
+import { findSessionFiles } from "./lib/session-audit.js";
+function buildCheck(id, label, status, detail) {
+    return { id, label, status, detail };
+}
+function iconFor(status) {
+    return status === "ok" ? "OK" : "WARN";
+}
+export async function runDoctorCommand(opts) {
+    const resolution = resolveSessionPath(opts.path || undefined, process.env);
+    const resolvedPath = resolution.path;
+    const sessionFiles = resolvedPath ? findSessionFiles(resolvedPath) : [];
+    const hookInstalled = isHookInstalled(readSettings(getSettingsPath()));
+    const narrationAvailable = resolveAuth() !== null;
+    const menubarInstalled = process.platform === "darwin" && isMenubarInstalled();
+    const menubarConfigExists = existsSync(getMenubarConfigPath());
+    const menubarStateExists = existsSync(getMenubarStatePath());
+    const candidates = findClaudeProjectCandidates();
+    const checks = [
+        buildCheck("sessions-root", "Claude Code projects", candidates.length > 0 ? "ok" : "warn", candidates.length > 0
+            ? `${candidates.length} project(s) with session history found`
+            : "No Claude Code project with session history was found"),
+        buildCheck("resolved-path", "Resolved session source", resolvedPath ? "ok" : "warn", resolvedPath
+            ? `${resolution.source}: ${basename(resolvedPath)}`
+            : "No session path could be resolved automatically"),
+        buildCheck("session-files", "Session files", sessionFiles.length > 0 ? "ok" : "warn", resolvedPath
+            ? `${sessionFiles.length} .jsonl file(s) in ${resolvedPath}`
+            : "No resolved project to scan"),
+        buildCheck("hook", "SessionEnd hook", hookInstalled ? "ok" : "warn", hookInstalled
+            ? `Installed in ${getSettingsPath()}`
+            : "Not installed. Run temet install-hook"),
+        buildCheck("narration", "Narration access", narrationAvailable ? "ok" : "warn", narrationAvailable
+            ? "Token detected for LLM narration"
+            : "No ANTHROPIC_API_KEY or CLAUDE_AUTH_TOKEN detected"),
+        buildCheck("menubar-app", "Temet app", process.platform !== "darwin" ? "warn" : menubarInstalled ? "ok" : "warn", process.platform !== "darwin"
+            ? "Temet app is only available on macOS"
+            : menubarInstalled
+                ? `Installed at ${getMenubarAppPath()}`
+                : "Not installed. Run temet install-menubar"),
+        buildCheck("menubar-config", "Temet app config", process.platform !== "darwin"
+            ? "warn"
+            : menubarConfigExists
+                ? "ok"
+                : "warn", process.platform !== "darwin"
+            ? "Not applicable on this platform"
+            : menubarConfigExists
+                ? `Config present at ${getMenubarConfigPath()}`
+                : "No menubar config found yet"),
+        buildCheck("menubar-state", "Temet app state", menubarStateExists ? "ok" : "warn", menubarStateExists
+            ? `Sidecar present at ${getMenubarStatePath()}`
+            : "No menubar state written yet. Run temet audit --track"),
+    ];
+    const report = {
+        version: 1,
+        checks,
+        summary: {
+            ok: checks.filter((check) => check.status === "ok").length,
+            warn: checks.filter((check) => check.status === "warn").length,
+        },
+    };
+    if (opts.json) {
+        console.log(JSON.stringify(report, null, "\t"));
+        return;
+    }
+    console.log("Temet doctor");
+    console.log("");
+    for (const check of checks) {
+        console.log(`${iconFor(check.status)}  ${check.label}`);
+        console.log(`    ${check.detail}`);
+    }
+    console.log("");
+    console.log(`Summary: ${report.summary.ok} OK, ${report.summary.warn} warning${report.summary.warn === 1 ? "" : "s"}`);
+}

package/dist/index.js

@@ -1,8 +1,10 @@
 #!/usr/bin/env node
 import { execFile } from "node:child_process";
+import { readFileSync } from "node:fs";
 import { chmod, mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 import { promisify } from "node:util";
 import { buildAuditCliOptions, parseFlagBag, readOptionalString, } from "./lib/cli-args.js";
 const execFileAsync = promisify(execFile);
@@ -11,10 +13,22 @@ const DEFAULT_SERVER_NAME = "temet";
 const DEFAULT_PROTOCOL_APP_NAME = "Temet Handler";
 const LINUX_DESKTOP_ENTRY = "temet-handler.desktop";
 const LINUX_HANDLER_SCRIPT = "temet-protocol-handler";
-const HELP = `Temet CLI — discover the skills you already demonstrate in AI work
+const PACKAGE_JSON_PATH = fileURLToPath(new URL("../package.json", import.meta.url));
+function readCliVersion() {
+    try {
+        const packageJson = JSON.parse(readFileSync(PACKAGE_JSON_PATH, "utf8"));
+        return packageJson.version || "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+const CLI_VERSION = readCliVersion();
+const HELP = `Temet CLI ${CLI_VERSION} — discover the skills you already demonstrate in AI work
 
 Commands:
 \ttemet audit [--path <session-dir>]        Analyze local sessions, surface skills and workflows
+\ttemet doctor [--path <session-dir>]       Check local Temet setup, sessions, hook, and app state
 \ttemet traces [--path <session-dir>]       Show the evidence behind the strongest signals
 \ttemet plan [--path <session-dir>]         Turn the current audit into an operating plan
 \ttemet install-hook                        Auto-audit after every Claude Code session
@@ -41,6 +55,7 @@ Advanced:
 
 Examples:
 \ttemet audit                                            Auto-detect sessions from cwd
+\ttemet doctor                                           Check whether Temet is fully wired on this machine
 \ttemet audit                                            Open the text report by default
 \ttemet traces                                           Inspect the proof behind the current reading
 \ttemet plan                                             Get the current operating plan
@@ -55,6 +70,10 @@ function printHelp(exitCode = 0) {
     console.log(HELP);
     process.exit(exitCode);
 }
+function printVersion() {
+    console.log(CLI_VERSION);
+    process.exit(0);
+}
 function isObject(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -147,6 +166,9 @@ function parseConnectUrlOptions(flags, positionals) {
     };
 }
 function parseArgs(argv) {
+    if (argv.includes("-v") || argv.includes("--version")) {
+        printVersion();
+    }
     if (argv.length === 0 || argv.includes("-h") || argv.includes("--help")) {
         printHelp(0);
     }
@@ -159,6 +181,15 @@ function parseArgs(argv) {
             options: buildAuditCliOptions(flags, process.env),
         };
     }
+    if (command === "doctor") {
+        return {
+            command,
+            options: {
+                path: readOptionalString(flags, "path") ?? undefined,
+                json: Boolean(flags.get("json")),
+            },
+        };
+    }
     if (command === "traces" || command === "plan") {
         return {
             command,
@@ -511,6 +542,11 @@ async function run() {
         await runAuditCommand(parsed.options);
         return;
     }
+    if (parsed.command === "doctor") {
+        const { runDoctorCommand } = await import("./doctor.js");
+        await runDoctorCommand(parsed.options);
+        return;
+    }
     if (parsed.command === "traces") {
         const { runTracesCommand } = await import("./traces.js");
         await runTracesCommand(parsed.options);

package/dist/lib/diagnostic-runner.js

@@ -1,6 +1,6 @@
 import { basename } from "node:path";
 import { createInterface } from "node:readline";
-import { resolveSessionPath } from "./path-resolver.js";
+import { findClaudeProjectCandidates, resolveSessionPath, } from "./path-resolver.js";
 import { trackAuditSnapshot } from "./audit-tracking.js";
 import { findSessionFiles, runAudit, } from "./session-audit.js";
 async function chooseSessionCandidate(candidates) {
@@ -55,7 +55,18 @@ export async function resolveDiagnostics(opts) {
             process.stderr.write(`[temet] using ${label}\n`);
         }
     }
-    const sessionFiles = findSessionFiles(resolvedPath);
+    let sessionFiles = findSessionFiles(resolvedPath);
+    if (sessionFiles.length === 0 && !opts.path && !opts.quiet && !opts.json) {
+        const candidates = findClaudeProjectCandidates();
+        if (candidates.length > 0) {
+            const selected = await chooseSessionCandidate(candidates);
+            if (selected) {
+                resolvedPath = selected.sessionDir;
+                sessionFiles = findSessionFiles(resolvedPath);
+                process.stderr.write(`[temet] using ${selected.label}\n`);
+            }
+        }
+    }
     if (sessionFiles.length === 0) {
         throw new Error(`No .jsonl session files found in ${resolvedPath}.`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@temet/cli",
-	"version": "0.3.2",
+	"version": "0.3.3",
 	"description": "Temet CLI — discover the skills you already demonstrate in AI work",
 	"keywords": [
 		"temet",