@tutorflow/cli 0.1.2 → 0.2.0

package/dist/utils/runtime.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Runtime helpers shared by every command.
+ *
+ * Output mode and debug are set once on the root program and read here so
+ * subcommands don't need to thread options through. They are the *only*
+ * pieces of mutable global state in the CLI.
+ */
+export declare function setJsonMode(on: boolean): void;
+export declare function setDebugMode(on: boolean): void;
+export declare function isJsonMode(): boolean;
+export declare function isDebugMode(): boolean;
+/**
+ * True when stdin is connected to a terminal. False in CI, pipes,
+ * AI agent sandboxes, etc. — i.e. anywhere `@clack/prompts` would crash.
+ */
+export declare function isInteractive(): boolean;
+/**
+ * Wrap a command action so:
+ *  - thrown errors always set exit code 1 (or the error's `exitCode`)
+ *  - in JSON mode, errors are serialized as { error: { message, code? } }
+ *  - in text mode, errors are formatted via `printError`
+ *  - stack traces are printed only when DEBUG / --debug is on
+ */
+export declare function command<T extends unknown[]>(fn: (...args: T) => Promise<void> | void): (...args: T) => Promise<void>;
+export declare class CliError extends Error {
+    readonly code: string;
+    readonly exitCode: number;
+    constructor(message: string, opts?: {
+        code?: string;
+        exitCode?: number;
+    });
+}
+export declare function printError(error: unknown): void;
+/**
+ * Refuse to launch an interactive prompt in a non-TTY environment.
+ * `hint` should describe the flags the caller could use instead.
+ */
+export declare function requireInteractive(hint: string): void;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/utils/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/utils/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,wBAAgB,WAAW,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAE7C;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAE9C;AAED,wBAAgB,UAAU,IAAI,OAAO,CAGpC;AAED,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,OAAO,EAAE,EACzC,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GACvC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAS/B;AAED,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO;CAK7E;AAiBD,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAc/C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAMrD"}

package/dist/utils/runtime.js

@@ -0,0 +1,105 @@
+"use strict";
+/**
+ * Runtime helpers shared by every command.
+ *
+ * Output mode and debug are set once on the root program and read here so
+ * subcommands don't need to thread options through. They are the *only*
+ * pieces of mutable global state in the CLI.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliError = void 0;
+exports.setJsonMode = setJsonMode;
+exports.setDebugMode = setDebugMode;
+exports.isJsonMode = isJsonMode;
+exports.isDebugMode = isDebugMode;
+exports.isInteractive = isInteractive;
+exports.command = command;
+exports.printError = printError;
+exports.requireInteractive = requireInteractive;
+let jsonMode = false;
+let debugMode = false;
+function setJsonMode(on) {
+    jsonMode = on;
+}
+function setDebugMode(on) {
+    debugMode = on;
+}
+function isJsonMode() {
+    // Env var override lets agents set this once globally without a flag.
+    return jsonMode || process.env.TUTORFLOW_JSON === '1';
+}
+function isDebugMode() {
+    return debugMode || process.env.DEBUG === '1' || process.env.TUTORFLOW_DEBUG === '1';
+}
+/**
+ * True when stdin is connected to a terminal. False in CI, pipes,
+ * AI agent sandboxes, etc. — i.e. anywhere `@clack/prompts` would crash.
+ */
+function isInteractive() {
+    return Boolean(process.stdin.isTTY) && Boolean(process.stdout.isTTY);
+}
+/**
+ * Wrap a command action so:
+ *  - thrown errors always set exit code 1 (or the error's `exitCode`)
+ *  - in JSON mode, errors are serialized as { error: { message, code? } }
+ *  - in text mode, errors are formatted via `printError`
+ *  - stack traces are printed only when DEBUG / --debug is on
+ */
+function command(fn) {
+    return async (...args) => {
+        try {
+            await fn(...args);
+        }
+        catch (error) {
+            printError(error);
+            process.exit(getExitCode(error));
+        }
+    };
+}
+class CliError extends Error {
+    constructor(message, opts = {}) {
+        super(message);
+        this.code = opts.code ?? 'EGENERIC';
+        this.exitCode = opts.exitCode ?? 1;
+    }
+}
+exports.CliError = CliError;
+function getExitCode(error) {
+    if (error instanceof CliError)
+        return error.exitCode;
+    return 1;
+}
+function getErrorCode(error) {
+    if (error instanceof CliError)
+        return error.code;
+    return 'EGENERIC';
+}
+function getErrorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+function printError(error) {
+    const message = getErrorMessage(error);
+    const code = getErrorCode(error);
+    if (isJsonMode()) {
+        process.stderr.write(JSON.stringify({ error: { message, code } }) + '\n');
+    }
+    else {
+        // chalk is loaded by callers; keep this dependency-free and use ANSI directly.
+        process.stderr.write(`\x1b[31m✗ ${message}\x1b[0m\n`);
+    }
+    if (isDebugMode() && error instanceof Error && error.stack) {
+        process.stderr.write(error.stack + '\n');
+    }
+}
+/**
+ * Refuse to launch an interactive prompt in a non-TTY environment.
+ * `hint` should describe the flags the caller could use instead.
+ */
+function requireInteractive(hint) {
+    if (isInteractive())
+        return;
+    throw new CliError(`Required input not provided and stdin is not a terminal. ${hint}`, { code: 'ENOINTERACTIVE', exitCode: 2 });
+}
+//# sourceMappingURL=runtime.js.map

package/dist/utils/runtime.js.map

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

package/package.json

@@ -1,7 +1,23 @@
 {
   "name": "@tutorflow/cli",
-  "version": "0.1.2",
-  "description": "TutorFlow CLI for creating AI-powered educational content (slides, videos, courses) and evaluating student responses.",
+  "version": "0.2.0",
+  "description": "TutorFlow CLI - agent-friendly tool for creating AI-powered educational content (slides, videos, courses) and evaluating student responses. Supports --json output, env-var auth, and non-interactive use.",
+  "keywords": [
+    "tutorflow",
+    "education",
+    "edtech",
+    "ai",
+    "ai-content",
+    "slides",
+    "video",
+    "course",
+    "tutor",
+    "lesson",
+    "evaluation",
+    "cli",
+    "agent",
+    "automation"
+  ],
   "bin": {
     "tutorflow": "./dist/index.js"
   },