@indykish/oracle 0.9.0

package/dist/scripts/check.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env bun
+import process from 'node:process';
+const buildConfig = {
+    entrypoints: ['./bin/oracle-cli.js'],
+    outdir: './.bun-check',
+    target: 'bun',
+    minify: false,
+    write: false,
+};
+const result = await Bun.build(buildConfig);
+if (!result.success) {
+    console.error('Build failed while checking syntax:');
+    for (const log of result.logs) {
+        console.error(log.message);
+        if (log.position) {
+            console.error(`\tat ${log.position.file}:${log.position.line}:${log.position.column}`);
+        }
+    }
+    process.exit(1);
+}
+console.log('Syntax OK');

package/dist/scripts/debug/extract-chatgpt-response.js

@@ -0,0 +1,53 @@
+import puppeteer from 'puppeteer-core';
+const port = parseInt(process.argv[2] || '52990', 10);
+async function main() {
+    const browser = await puppeteer.connect({
+        browserURL: `http://127.0.0.1:${port}`,
+        defaultViewport: null,
+    });
+    const pages = await browser.pages();
+    let targetPage = null;
+    for (const page of pages) {
+        const url = page.url();
+        if (url.includes('chatgpt.com/c/')) {
+            targetPage = page;
+            break;
+        }
+    }
+    if (!targetPage) {
+        console.error('ChatGPT conversation page not found');
+        process.exit(1);
+    }
+    console.error('Found page:', await targetPage.url());
+    // Extract the last assistant message
+    const content = (await targetPage.evaluate(() => {
+        // Try multiple selectors for ChatGPT's assistant messages
+        const selectors = [
+            '[data-message-author-role="assistant"] .markdown',
+            '[data-message-author-role="assistant"]',
+            '.agent-turn .markdown',
+            '.agent-turn',
+        ];
+        for (const selector of selectors) {
+            const elements = document.querySelectorAll(selector);
+            if (elements.length > 0) {
+                const lastEl = elements[elements.length - 1];
+                return {
+                    selector,
+                    count: elements.length,
+                    text: lastEl.innerText,
+                };
+            }
+        }
+        // Debug: show what's on the page
+        const body = document.body.innerHTML;
+        return { error: 'No messages found', bodyLength: body.length, sample: body.slice(0, 2000) };
+    }));
+    if ('error' in content) {
+        console.error('Error:', JSON.stringify(content, null, 2));
+        process.exit(1);
+    }
+    console.log(content.text);
+    browser.disconnect();
+}
+main().catch(console.error);

package/dist/scripts/docs-list.js

@@ -0,0 +1,110 @@
+#!/usr/bin/env tsx
+import { readdirSync, readFileSync } from 'node:fs';
+import { dirname, join, relative } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { compact } from 'es-toolkit';
+const docsListFile = fileURLToPath(import.meta.url);
+const docsListDir = dirname(docsListFile);
+const DOCS_DIR = join(docsListDir, '..', 'docs');
+const EXCLUDED_DIRS = new Set(['archive', 'research']);
+function walkMarkdownFiles(dir, base = dir) {
+    const entries = readdirSync(dir, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        if (entry.name.startsWith('.')) {
+            continue;
+        }
+        const fullPath = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (EXCLUDED_DIRS.has(entry.name)) {
+                continue;
+            }
+            files.push(...walkMarkdownFiles(fullPath, base));
+        }
+        else if (entry.isFile() && entry.name.endsWith('.md')) {
+            files.push(relative(base, fullPath));
+        }
+    }
+    return files.sort((a, b) => a.localeCompare(b));
+}
+function extractMetadata(fullPath) {
+    const content = readFileSync(fullPath, 'utf8');
+    if (!content.startsWith('---')) {
+        return { summary: null, readWhen: [], error: 'missing front matter' };
+    }
+    const endIndex = content.indexOf('\n---', 3);
+    if (endIndex === -1) {
+        return { summary: null, readWhen: [], error: 'unterminated front matter' };
+    }
+    const frontMatter = content.slice(3, endIndex).trim();
+    const lines = frontMatter.split('\n');
+    let summaryLine = null;
+    const readWhen = [];
+    let collectingField = null;
+    for (const rawLine of lines) {
+        const line = rawLine.trim();
+        if (line.startsWith('summary:')) {
+            summaryLine = line;
+            collectingField = null;
+            continue;
+        }
+        if (line.startsWith('read_when:')) {
+            collectingField = 'read_when';
+            const inline = line.slice('read_when:'.length).trim();
+            if (inline.startsWith('[') && inline.endsWith(']')) {
+                try {
+                    const parsed = JSON.parse(inline.replace(/'/g, '"'));
+                    if (Array.isArray(parsed)) {
+                        readWhen.push(...compact(parsed.map((item) => String(item).trim())));
+                    }
+                }
+                catch {
+                    // ignore malformed inline arrays
+                }
+            }
+            continue;
+        }
+        if (collectingField === 'read_when') {
+            if (line.startsWith('- ')) {
+                const hint = line.slice(2).trim();
+                if (hint) {
+                    readWhen.push(hint);
+                }
+            }
+            else if (line === '') {
+            }
+            else {
+                collectingField = null;
+            }
+        }
+    }
+    if (!summaryLine) {
+        return { summary: null, readWhen, error: 'summary key missing' };
+    }
+    const summaryValue = summaryLine.slice('summary:'.length).trim();
+    const normalized = summaryValue
+        .replace(/^['"]|['"]$/g, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+    if (!normalized) {
+        return { summary: null, readWhen, error: 'summary is empty' };
+    }
+    return { summary: normalized, readWhen };
+}
+console.log('Listing all markdown files in docs folder:');
+const markdownFiles = walkMarkdownFiles(DOCS_DIR);
+for (const relativePath of markdownFiles) {
+    const fullPath = join(DOCS_DIR, relativePath);
+    const { summary, readWhen, error } = extractMetadata(fullPath);
+    if (summary) {
+        console.log(`${relativePath} - ${summary}`);
+        if (readWhen.length > 0) {
+            console.log(`  Read when: ${readWhen.join('; ')}`);
+        }
+    }
+    else {
+        const reason = error ? ` - [${error}]` : '';
+        console.log(`${relativePath}${reason}`);
+    }
+}
+console.log('\nReminder: keep docs up to date as behavior changes. When your task matches any "Read when" hint above (React hooks, cache directives, database work, tests, etc.), read that doc before coding, and suggest new coverage when it is missing.');

package/dist/scripts/git-policy.js

@@ -0,0 +1,125 @@
+import { resolve } from 'node:path';
+const COMMIT_HELPER_SUBCOMMANDS = new Set(['add', 'commit']);
+const GUARDED_SUBCOMMANDS = new Set(['push', 'pull', 'merge', 'rebase', 'cherry-pick']);
+const DESTRUCTIVE_SUBCOMMANDS = new Set([
+    'reset',
+    'checkout',
+    'clean',
+    'restore',
+    'switch',
+    'stash',
+    'branch',
+    'filter-branch',
+    'fast-import',
+]);
+export function extractGitInvocation(commandArgs) {
+    for (const [index, token] of commandArgs.entries()) {
+        if (token === 'git' || token.endsWith('/git')) {
+            return { index, argv: commandArgs.slice(index) };
+        }
+    }
+    return null;
+}
+export function findGitSubcommand(commandArgs) {
+    if (commandArgs.length <= 1) {
+        return null;
+    }
+    const optionsWithValue = new Set(['-C', '--git-dir', '--work-tree', '-c']);
+    let index = 1;
+    while (index < commandArgs.length) {
+        const token = commandArgs[index];
+        if (token === undefined) {
+            break;
+        }
+        if (token === '--') {
+            const next = commandArgs[index + 1];
+            return next ? { name: next, index: index + 1 } : null;
+        }
+        if (!token.startsWith('-')) {
+            return { name: token, index };
+        }
+        if (token.includes('=')) {
+            index += 1;
+            continue;
+        }
+        if (optionsWithValue.has(token)) {
+            index += 2;
+            continue;
+        }
+        index += 1;
+    }
+    return null;
+}
+export function determineGitWorkdir(baseDir, gitArgs, command) {
+    let workDir = baseDir;
+    const limit = command ? command.index : gitArgs.length;
+    let index = 1;
+    while (index < limit) {
+        const token = gitArgs[index];
+        if (token === undefined) {
+            break;
+        }
+        if (token === '-C') {
+            const next = gitArgs[index + 1];
+            if (next) {
+                workDir = resolve(workDir, next);
+            }
+            index += 2;
+            continue;
+        }
+        if (token.startsWith('-C')) {
+            const pathSegment = token.slice(2);
+            if (pathSegment.length > 0) {
+                workDir = resolve(workDir, pathSegment);
+            }
+        }
+        index += 1;
+    }
+    return workDir;
+}
+export function analyzeGitExecution(commandArgs, workspaceDir) {
+    const invocation = extractGitInvocation(commandArgs);
+    const command = invocation ? findGitSubcommand(invocation.argv) : null;
+    const workDir = invocation ? determineGitWorkdir(workspaceDir, invocation.argv, command) : workspaceDir;
+    return {
+        invocation,
+        command,
+        subcommand: command?.name ?? null,
+        workDir,
+    };
+}
+export function requiresCommitHelper(subcommand) {
+    if (!subcommand) {
+        return false;
+    }
+    return COMMIT_HELPER_SUBCOMMANDS.has(subcommand);
+}
+export function requiresExplicitGitConsent(subcommand) {
+    if (!subcommand) {
+        return false;
+    }
+    return GUARDED_SUBCOMMANDS.has(subcommand);
+}
+export function isDestructiveGitSubcommand(command, gitArgv) {
+    if (!command) {
+        return false;
+    }
+    const subcommand = command.name;
+    if (DESTRUCTIVE_SUBCOMMANDS.has(subcommand)) {
+        return true;
+    }
+    if (subcommand === 'bisect') {
+        const action = gitArgv[command.index + 1] ?? '';
+        return action === 'reset';
+    }
+    return false;
+}
+export function evaluateGitPolicies(context) {
+    const invocationArgv = context.invocation?.argv;
+    const normalizedArgv = Array.isArray(invocationArgv) ? invocationArgv : [];
+    return {
+        requiresCommitHelper: requiresCommitHelper(context.subcommand),
+        requiresExplicitConsent: requiresExplicitGitConsent(context.subcommand),
+        isDestructive: isDestructiveGitSubcommand(context.command, normalizedArgv),
+    };
+}

package/dist/scripts/run-cli.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { spawn } from 'node:child_process';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const rawArgs = process.argv.slice(2);
+const args = rawArgs[0] === '--' ? rawArgs.slice(1) : rawArgs;
+const here = path.dirname(fileURLToPath(import.meta.url));
+const cliEntry = path.join(here, '../bin/oracle-cli.js');
+const child = spawn(process.execPath, ['--', cliEntry, ...args], {
+    stdio: 'inherit',
+});
+child.on('exit', (code) => {
+    process.exit(code ?? 0);
+});