opensteer 0.3.0 → 0.4.0

package/bin/opensteer.mjs

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 
+import { createHash } from 'crypto'
 import { spawn } from 'child_process'
-import { existsSync, readFileSync, readdirSync, unlinkSync } from 'fs'
+import { existsSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from 'fs'
 import { connect } from 'net'
 import { tmpdir } from 'os'
 import { basename, dirname, join } from 'path'
@@ -18,6 +19,15 @@ const SOCKET_SUFFIX = '.sock'
 const PID_SUFFIX = '.pid'
 const CLOSE_ALL_REQUEST = { id: 1, command: 'close', args: {} }
 
+function getVersion() {
+    try {
+        const pkgPath = join(__dirname, '..', 'package.json')
+        return JSON.parse(readFileSync(pkgPath, 'utf-8')).version
+    } catch {
+        return 'unknown'
+    }
+}
+
 function parseArgs(argv) {
     const args = argv.slice(2)
     if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
@@ -25,6 +35,11 @@ function parseArgs(argv) {
         process.exit(0)
     }
 
+    if (args[0] === '--version' || args[0] === '-v') {
+        console.log(getVersion())
+        process.exit(0)
+    }
+
     const command = args[0]
     const flags = {}
     const positional = []
@@ -69,24 +84,51 @@ function sanitizeNamespace(value) {
     return bounded || 'default'
 }
 
+function getActiveNamespacePath() {
+    const hash = createHash('md5').update(process.cwd()).digest('hex').slice(0, 16)
+    return join(tmpdir(), `${RUNTIME_PREFIX}active-${hash}`)
+}
+
+function readActiveNamespace() {
+    try {
+        const filePath = getActiveNamespacePath()
+        if (!existsSync(filePath)) return null
+        const ns = readFileSync(filePath, 'utf-8').trim()
+        return ns || null
+    } catch {
+        return null
+    }
+}
+
+function writeActiveNamespace(namespace) {
+    try {
+        writeFileSync(getActiveNamespacePath(), namespace)
+    } catch { /* best-effort */ }
+}
+
 function resolveNamespace(flags) {
     if (flags.name !== undefined && String(flags.name).trim().length > 0) {
-        return sanitizeNamespace(String(flags.name))
+        return { namespace: sanitizeNamespace(String(flags.name)), source: 'flag' }
     }
 
     if (
         typeof process.env.OPENSTEER_NAME === 'string' &&
         process.env.OPENSTEER_NAME.trim().length > 0
     ) {
-        return sanitizeNamespace(process.env.OPENSTEER_NAME)
+        return { namespace: sanitizeNamespace(process.env.OPENSTEER_NAME), source: 'env' }
+    }
+
+    const active = readActiveNamespace()
+    if (active && isServerRunning(active)) {
+        return { namespace: active, source: 'active' }
     }
 
     const cwdBase = basename(process.cwd())
     if (cwdBase && cwdBase !== '.' && cwdBase !== '/') {
-        return sanitizeNamespace(cwdBase)
+        return { namespace: sanitizeNamespace(cwdBase), source: 'cwd' }
     }
 
-    return 'default'
+    return { namespace: 'default', source: 'default' }
 }
 
 function getSocketPath(namespace) {
@@ -427,6 +469,7 @@ Navigation:
 
 Sessions:
   sessions                  List active namespace-scoped sessions
+  status                    Show resolved namespace and session state
 
 Observation:
   snapshot [--mode action]  Get page snapshot
@@ -481,6 +524,7 @@ Global Flags:
   --selector <css>          Target element by CSS selector
   --description <text>      Description for selector persistence
   --help                    Show this help
+  --version, -v             Show version
 
 Environment:
   OPENSTEER_NAME            Default session namespace when --name is omitted
@@ -492,7 +536,7 @@ Environment:
 
 async function main() {
     const { command, flags, positional } = parseArgs(process.argv)
-    const namespace = resolveNamespace(flags)
+    const { namespace, source: namespaceSource } = resolveNamespace(flags)
     const socketPath = getSocketPath(namespace)
 
     if (command === 'sessions') {
@@ -500,6 +544,18 @@ async function main() {
         return
     }
 
+    if (command === 'status') {
+        output({
+            ok: true,
+            namespace,
+            namespaceSource,
+            serverRunning: isServerRunning(namespace),
+            socketPath,
+            sessions: listSessions(),
+        })
+        return
+    }
+
     if (command === 'close' && flags.all === true) {
         try {
             const closed = await closeAllSessions()
@@ -515,6 +571,11 @@ async function main() {
     const request = buildRequest(command, flags, positional)
 
     if (!isServerRunning(namespace)) {
+        if (command !== 'open') {
+            error(
+                `No server running for namespace '${namespace}' (resolved from ${namespaceSource}). Run 'opensteer open' first or use 'opensteer sessions' to see active sessions.`
+            )
+        }
         if (!existsSync(SERVER_SCRIPT)) {
             error(
                 `Server script not found: ${SERVER_SCRIPT}. Run the build script first.`
@@ -532,6 +593,9 @@ async function main() {
         const response = await sendCommand(socketPath, request)
 
         if (response.ok) {
+            if (command === 'open') {
+                writeActiveNamespace(namespace)
+            }
             output({ ok: true, ...response.result })
         } else {
             process.stderr.write(

package/dist/cli/server.cjs

@@ -9856,7 +9856,7 @@ async function handleRequest(request, socket) {
     sendResponse(socket, {
       id,
       ok: false,
-      error: "No browser session. Call 'opensteer open' first."
+      error: `No browser session in namespace '${namespace}'. Call 'opensteer open --name ${namespace}' first, or use 'opensteer sessions' to list active sessions.`
     });
     return;
   }

package/dist/cli/server.js

@@ -365,7 +365,7 @@ async function handleRequest(request, socket) {
     sendResponse(socket, {
       id,
       ok: false,
-      error: "No browser session. Call 'opensteer open' first."
+      error: `No browser session in namespace '${namespace}'. Call 'opensteer open --name ${namespace}' first, or use 'opensteer sessions' to list active sessions.`
     });
     return;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "opensteer",
-    "version": "0.3.0",
+    "version": "0.4.0",
     "packageManager": "pnpm@10.29.3",
     "description": "Open-source browser automation SDK with robust selectors and deterministic replay.",
     "license": "MIT",