@steipete/oracle 1.0.2 → 1.0.6

package/README.md

@@ -32,6 +32,9 @@ npx -y @steipete/oracle --engine browser -p "Summarize the risk register" --file
 # Globs/exclusions
 npx -y @steipete/oracle -p "Review the TS data layer" --file "src/**/*.ts" --file "!src/**/*.test.ts"
 
+# Mixed glob + single file
+npx -y @steipete/oracle -p "Audit data layer" --file "src/**/*.ts" --file README.md
+
 # Inspect past sessions
 oracle status --clear --hours 168   # prune a week of cached runs
 oracle status                       # list runs; grab an ID
@@ -82,4 +85,5 @@ pnpm test:coverage
 ---
 
 If you’re looking for an even more powerful context-management tool, check out https://repoprompt.com
+
 Name inspired by: https://ampcode.com/news/oracle

package/dist/bin/oracle-cli.js

@@ -39,7 +39,10 @@ program.hook('preAction', (thisCommand) => {
         thisCommand.setOptionValue('prompt', positional);
     }
     if (shouldRequirePrompt(rawCliArgs, opts)) {
-        throw new Error('Prompt is required. Provide it via --prompt "<text>".');
+        console.log(chalk.yellow('Prompt is required. Provide it via --prompt "<text>" or positional [prompt].'));
+        thisCommand.help({ error: false });
+        process.exitCode = 1;
+        return;
     }
 });
 program

package/dist/src/cli/help.js

@@ -47,7 +47,7 @@ function renderHelpFooter(program, colors) {
         `${colors.bullet('•')} The model has no built-in knowledge of your project—open with the architecture, key components, and why you’re asking.`,
         `${colors.bullet('•')} Run ${colors.accent('--files-report')} to inspect token spend before hitting the API.`,
         `${colors.bullet('•')} Non-preview runs spawn detached sessions so they keep streaming even if your terminal closes — reattach anytime via ${colors.accent('pnpm oracle session <slug>')}.`,
-        `${colors.bullet('•')} Ask the model for a memorable 3–5 word slug and pass it via ${colors.accent('--slug "<words>"')} to keep session IDs tidy.`,
+        `${colors.bullet('•')} Set a memorable 3–5 word slug via ${colors.accent('--slug "<words>"')} to keep session IDs tidy.`,
         `${colors.bullet('•')} Need hidden flags? Run ${colors.accent(`${program.name()} --help --verbose`)} to list search/token/browser overrides.`,
     ].join('\n');
     const formatExample = (command, description) => `${colors.command(`  ${command}`)}\n${colors.muted(`    ${description}`)}`;

package/dist/src/cli/sessionDisplay.js

@@ -51,7 +51,6 @@ export async function attachSession(sessionId, options) {
     }
     const initialStatus = metadata.status;
     if (!options?.suppressMetadata) {
-        console.log(chalk.bold(`Session: ${sessionId}`));
         const reattachLine = buildReattachLine(metadata);
         if (reattachLine) {
             console.log(chalk.blue(reattachLine));

package/dist/src/oracle/run.js

@@ -26,6 +26,15 @@ const defaultWait = (ms) => new Promise((resolve) => {
 });
 export async function runOracle(options, deps = {}) {
     const { apiKey = options.apiKey ?? process.env.OPENAI_API_KEY, cwd = process.cwd(), fs: fsModule = createFsAdapter(fs), log = console.log, write = (text) => process.stdout.write(text), now = () => performance.now(), clientFactory = createDefaultClientFactory(), client, wait = defaultWait, } = deps;
+    const maskApiKey = (key) => {
+        if (!key)
+            return null;
+        if (key.length <= 8)
+            return `${key[0] ?? ''}***${key[key.length - 1] ?? ''}`;
+        const prefix = key.slice(0, 4);
+        const suffix = key.slice(-4);
+        return `${prefix}****${suffix}`;
+    };
     const logVerbose = (message) => {
         if (options.verbose) {
             log(dim(`[verbose] ${message}`));
@@ -38,6 +47,10 @@ export async function runOracle(options, deps = {}) {
             env: 'OPENAI_API_KEY',
         });
     }
+    const maskedKey = maskApiKey(apiKey);
+    if (maskedKey) {
+        log(dim(`Using OPENAI_API_KEY=${maskedKey}`));
+    }
     const modelConfig = MODEL_CONFIGS[options.model];
     if (!modelConfig) {
         throw new PromptValidationError(`Unsupported model "${options.model}". Choose one of: ${Object.keys(MODEL_CONFIGS).join(', ')}`, { model: options.model });
@@ -57,6 +70,9 @@ export async function runOracle(options, deps = {}) {
     }
     else {
         logVerbose('No files attached.');
+        if (!isPreview) {
+            log(dim('Tip: no files attached — Oracle works best with project context. Add files via --file path/to/code or docs.'));
+        }
     }
     const fileTokenInfo = getFileTokenStats(files, {
         cwd,
@@ -76,7 +92,11 @@ export async function runOracle(options, deps = {}) {
     logVerbose(`Estimated tokens (prompt + files): ${estimatedInputTokens.toLocaleString()}`);
     const fileCount = files.length;
     const cliVersion = getCliVersion();
-    const headerLine = `Oracle (${cliVersion}) consulting ${modelConfig.model}'s crystal ball with ${estimatedInputTokens.toLocaleString()} tokens and ${fileCount} files...`;
+    const richTty = process.stdout.isTTY && chalk.level > 0;
+    const headerModelLabel = richTty ? chalk.cyan(modelConfig.model) : modelConfig.model;
+    const tokenLabel = richTty ? chalk.green(estimatedInputTokens.toLocaleString()) : estimatedInputTokens.toLocaleString();
+    const fileLabel = richTty ? chalk.magenta(fileCount.toString()) : fileCount.toString();
+    const headerLine = `Oracle (${cliVersion}) consulting ${headerModelLabel}'s crystal ball with ${tokenLabel} tokens and ${fileLabel} files...`;
     const shouldReportFiles = (options.filesReport || fileTokenInfo.totalTokens > inputTokenBudget) && fileTokenInfo.stats.length > 0;
     if (!isPreview) {
         log(headerLine);
@@ -129,6 +149,7 @@ export async function runOracle(options, deps = {}) {
     let answerHeaderPrinted = false;
     const ensureAnswerHeader = () => {
         if (!options.silent && !answerHeaderPrinted) {
+            log('');
             log(chalk.bold('Answer:'));
             answerHeaderPrinted = true;
         }
@@ -309,7 +330,7 @@ async function executeBackgroundResponse(params) {
             isActive: () => heartbeatActive,
             makeMessage: (elapsedMs) => {
                 const elapsedText = formatElapsed(elapsedMs);
-                return `OpenAI background run still in progress — ${elapsedText} elapsed (id=${responseId}).`;
+                return `OpenAI background run still in progress — ${elapsedText} elapsed.`;
             },
         });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steipete/oracle",
-  "version": "1.0.2",
+  "version": "1.0.6",
   "description": "CLI wrapper around OpenAI Responses API with GPT-5 Pro and GPT-5.1 high reasoning modes.",
   "type": "module",
   "main": "dist/bin/oracle-cli.js",