aihand 0.0.1 → 0.1.0

package/src/cli.ts

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+/* eslint-disable no-console -- this is a CLI; stdout is its output channel */
+import process from 'node:process'
+import pc from 'picocolors'
+
+// Unified entry: route by the first segment to one of the three fused modules,
+// then hand the remaining argv to that module's own CLI (copied verbatim from
+// repodex/aihand — the routing layer is the red line: only `refactor` writes disk).
+//
+//   aihand read     panel|tree|source|--stdout|…    → read module (tree-sitter, read-only)
+//   aihand refactor move-file|rename|move-symbol …  → read module (ts-morph, writes disk)
+//   aihand runtime  screen|ui|dom|check|click|…     → runtime module (curl runtime probe)
+//
+// read & refactor share read/cli.ts: it dispatches on its own args[0], so after
+// stripping `read`/`refactor` the rest (move-file / source / …) still lands.
+
+const HELP = `
+${pc.bold('aihand')} — unified AI dev tool (read · refactor · runtime), one CLI
+
+${pc.dim('Modules:')}
+  ${pc.cyan('aihand read')}  <cmd>     read & understand code (read-only)
+    panel                 control-theoretic model: every knob × store state (--live ⋈ runtime)
+    tree                  file-tree navigation map (where files live / the layout)
+    source <file:line>    reverse morphism: runtime coord → static symbol + callers/callees
+    --stdout              print the full codemap (overview+panel+state+tree) — don't write disk
+    (no cmd)              inject the codemap into CLAUDE.md/AGENTS.md
+    --json                structured output
+
+  ${pc.cyan('aihand refactor')} <cmd> change source structure (AST via ts-morph, writes disk)
+    move-file <src> <dest>          move a file, rewrite all importers
+    rename <file> <old> <new>       rename a symbol across the project
+    move-symbol <from> <name> <to>  move one symbol, carry deps
+    --dry                           print diff, don't write
+
+  ${pc.cyan('aihand runtime')} <cmd>  inspect & drive the running browser app (in-app probe via Vite)
+    screen | ui | dom | check | console | network | errors
+    click | hover | fill | press | wait    (drive the page)
+    pass action params as flags: ${pc.dim('click --text=New · fill --sel=input --value=hi')}
+    --port=<port>         dev server port (default 5173)
+
+  ${pc.cyan('aihand probe')} <cmd>    drive ANY external website (out-of-app: own chromium + parachuted probe)
+    open <url>            launch chromium, inject the probe, navigate
+    screen               semantic layout + view/modal/focus + region fingerprint (zero app cooperation)
+    click | fill | press | hover | wait    (same kernel as runtime, CDP transport)
+
+${pc.dim('Setup:')}
+  Add ${pc.cyan('aihand()')} to your vite.config.ts plugins array.
+`
+
+async function main() {
+    const [mod, ...rest] = process.argv.slice(2)
+
+    if (!mod || mod === '--help' || mod === '-h') {
+        console.log(HELP)
+        process.exit(mod ? 0 : 1)
+    }
+
+    // The router is the single gate every module call passes. A module switched off in
+    // aihand.config.ts is refused here with a clear message — not a silent no-op.
+    const { loadConfig } = await import('./read/config.js')
+    const config = await loadConfig()
+    const refuse = (m: string) => {
+        console.error(pc.red(`'${m}' is disabled in aihand.config.ts (set ${m}: true to enable)`))
+        process.exit(1)
+    }
+
+    if (mod === 'read' || mod === 'refactor') {
+        // read/cli dispatches on rest[0] (move-file/context/…) — same as the
+        // original repodex single-main. `refactor` is just a documentation alias;
+        // its subcommands are already recognised by read/cli. The two share read/cli but
+        // gate independently: refactor writes disk, read doesn't.
+        if (mod === 'refactor' && !config.refactor.enabled)
+            refuse('refactor')
+        if (mod === 'read' && !config.read.enabled)
+            refuse('read')
+        const { runCli } = await import('./read/cli.js')
+        await runCli(rest)
+        return
+    }
+
+    if (mod === 'runtime') {
+        if (!config.runtime.enabled)
+            refuse('runtime')
+        const { run } = await import('./ui/server/cli.js')
+        await run(rest)
+        return
+    }
+
+    // 出口2:驱动任意外部站点(自带 chromium + 空降探针)。同属 runtime 能力(驱动浏览器),
+    // 同一 gate;与 `runtime`(出口1,连 Vite dev server 内的 app)是同一内核的两个出口。
+    if (mod === 'probe') {
+        if (!config.runtime.enabled)
+            refuse('runtime')
+        const { run } = await import('./ui/probe/cli.js')
+        await run(rest)
+        return
+    }
+
+    console.error(pc.red(`unknown module '${mod}' — expected read | refactor | runtime`))
+    console.log(HELP)
+    process.exit(1)
+}
+
+main().catch((err) => {
+    console.error(pc.red(`Error: ${err?.message ?? err}`))
+    process.exit(1)
+})

package/src/index.ts

@@ -0,0 +1,54 @@
+// aihand — unified AI dev tool: read (repodex) + refactor + runtime (aihand), fused.
+// The single vite plugin lives here too; CLI entry is src/cli.ts.
+
+export { aihand } from './vite.js'
+export type { RepodexPluginOptions } from './vite.js'
+
+// read module — static code analysis (tree-sitter) + injection
+export { cleanFnSignature, compact, extractImports, getLang, IMPORT_QUERY, SEPARATOR, TS_QUERY } from './read/compact.js'
+export type { CallGraph, SymbolNode } from './read/graph.js'
+export { buildCallGraph } from './read/graph.js'
+export { ensureMarkers, injectAll, injectFile } from './read/inject.js'
+export type { LocateResult } from './read/locate.js'
+export { locate, parseInspPath, renderLocate, sourcePanelHtml, symbolAtLine } from './read/locate.js'
+export type { Knob, Transition } from './read/panel.js'
+export { buildPanel, extractKnobs, fmtTransitions } from './read/panel.js'
+export type { LiveKnob, RuntimeKnob } from './read/seam.js'
+export { fetchRuntimeKnobs, fileOfInspPath, joinPanel } from './read/seam.js'
+export type { StateField, StoreState } from './read/state.js'
+export { buildState, formatState } from './read/state.js'
+export type { StateNode, StoreFieldRaw } from './read/stategraph.js'
+export { buildStateGraph, classify, extractStoreFields, growFromDecl, openProject } from './read/stategraph.js'
+export { buildBlocks, buildClassifier, formatTree, formatXml } from './read/render.js'
+export { scan } from './read/scan.js'
+export { scanSecrets } from './read/security.js'
+export { allocate, buildImportGraph, computeCentrality, computeRecency, expandByBudget } from './read/signals.js'
+export type { AidevConfig, Config, FileBlock, FileDetailLevel, ModuleSwitch, ReadOptions, RepodexData, RuntimeOptions } from './read/types.js'
+export { configTemplate, DEFAULT_CONFIG, defineConfig } from './read/types.js'
+
+// refactor module — AST refactors (ts-morph)
+export { moveFile, moveSymbol, renameSymbol } from './read/refactor.js'
+
+// runtime module — runtime browser probe (aihand)
+export { lineProfilerPlugin } from './ui/babel/line-profiler.js'
+export { check } from './ui/core/check.js'
+export { diffState } from './ui/core/diff.js'
+export { emitCheck, emitDiff, emitSummary } from './ui/core/emit.js'
+export type { CheckResult, CompactState, DiffResult, RawState } from './ui/core/types.js'
+
+// self module — 状态/输出端自表示(knobSchema 的对偶):从 store 源码长出值域 schema,
+// 运行时 synth/screenHook 把 schema ⋉ live store 投影成 __AIPEEK_SCREEN__ 同形状。
+// 三原语:self-rep(screen/synth 感知)/ self-log(log/installSelfLog 物理)/ self-act(act 变化)。
+export { act } from './ui/self/act.js'
+export { discover } from './ui/self/discover.js'
+export { grow } from './ui/self/grow.js'
+export type { Field, Grown } from './ui/self/grow.js'
+export { installSelfLog } from './ui/self/install.js'
+export type { Sink } from './ui/self/install.js'
+export { screenHook } from './ui/self/screen-hook.js'
+export type { ScreenHook, StoreSnap } from './ui/self/screen-hook.js'
+export { log, screen } from './ui/self/self.js'
+export type { LogEntry, Self } from './ui/self/self.js'
+export { storeSchema } from './ui/self/store-schema.js'
+export { synth } from './ui/self/synth.js'
+export type { Snapshot } from './ui/self/synth.js'