@steipete/oracle 1.0.1 → 1.0.5

package/README.md

@@ -24,13 +24,16 @@ If you omit `--engine`, Oracle prefers the API engine when `OPENAI_API_KEY` is p
 
 ```bash
 # One-off (no install)
-OPENAI_API_KEY=sk-... npx @steipete/oracle -p "Summarize the risk register" --file docs/risk-register.md docs/risk-matrix.md
+OPENAI_API_KEY=sk-... npx -y @steipete/oracle -p "Summarize the risk register" --file docs/risk-register.md docs/risk-matrix.md
 
 # Browser engine (no API key)
-npx @steipete/oracle --engine browser -p "Summarize the risk register" --file docs/risk-register.md docs/risk-matrix.md
+npx -y @steipete/oracle --engine browser -p "Summarize the risk register" --file docs/risk-register.md docs/risk-matrix.md
 
 # Globs/exclusions
-npx @steipete/oracle -p "Review the TS data layer" --file "src/**/*.ts" --file "!src/**/*.test.ts"
+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
@@ -40,7 +43,7 @@ oracle session <id>                 # replay a run locally
 
 ## How do I integrate this?
 
-- **One-liner in CI** — `OPENAI_API_KEY=sk-... npx @steipete/oracle --prompt "Smoke-check latest PR" --file src/ docs/ --preview summary` (add to your pipeline as a non-blocking report step).
+- **One-liner in CI** — `OPENAI_API_KEY=sk-... npx -y @steipete/oracle --prompt "Smoke-check latest PR" --file src/ docs/ --preview summary` (add to your pipeline as a non-blocking report step).
 - **Package script** — In `package.json`: `"oracle": "oracle --prompt \"Review the diff\" --file ."` then run `OPENAI_API_KEY=... pnpm oracle`.
 
 ## Highlights

package/dist/bin/oracle-cli.js

@@ -33,6 +33,11 @@ program.hook('preAction', (thisCommand) => {
         return;
     }
     const opts = thisCommand.optsWithGlobals();
+    const positional = thisCommand.args?.[0];
+    if (!opts.prompt && positional) {
+        opts.prompt = positional;
+        thisCommand.setOptionValue('prompt', positional);
+    }
     if (shouldRequirePrompt(rawCliArgs, opts)) {
         throw new Error('Prompt is required. Provide it via --prompt "<text>".');
     }
@@ -41,6 +46,7 @@ program
     .name('oracle')
     .description('One-shot GPT-5 Pro / GPT-5.1 tool for hard questions that benefit from large file context and server-side search.')
     .version(VERSION)
+    .argument('[prompt]', 'Prompt text (shorthand for --prompt).')
     .option('-p, --prompt <text>', 'User prompt to send to the model.')
     .option('-f, --file <paths...>', 'Files/directories or glob patterns to attach (prefix with !pattern to exclude). Files larger than 1 MB are rejected automatically.', collectPaths, [])
     .option('-s, --slug <words>', 'Custom session slug (3-5 words).')

package/dist/src/cli/sessionDisplay.js

@@ -9,7 +9,7 @@ export async function showStatus({ hours, includeAll, limit, showExamples = fals
     const { entries, truncated, total } = filterSessionsByRange(metas, { hours, includeAll, limit });
     const richTty = process.stdout.isTTY && chalk.level > 0;
     if (!entries.length) {
-        console.log('No sessions found for the requested range.');
+        console.log(CLEANUP_TIP);
         if (showExamples) {
             printStatusExamples();
         }

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,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steipete/oracle",
-  "version": "1.0.1",
+  "version": "1.0.5",
   "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",