Miosa-osa
diff --git a/‎README.md‎
Lines changed: 20 additions & 5 deletions b/‎README.md‎
Lines changed: 20 additions & 5 deletions
diff --git a/‎package-lock.json‎
Lines changed: 2 additions & 2 deletions b/‎package-lock.json‎
Lines changed: 2 additions & 2 deletions
diff --git a/‎package.json‎
Lines changed: 2 additions & 2 deletions b/‎package.json‎
Lines changed: 2 additions & 2 deletions
diff --git a/‎src/app-manifest.ts‎
Lines changed: 167 additions & 0 deletions b/‎src/app-manifest.ts‎
Lines changed: 167 additions & 0 deletions
@@ -138,6 +138,8 @@ Precedence: CLI flags > environment variables > config file > interactive prompt
 |---|---|
 | `MIOSA_API_KEY` | API key (overrides config file) |
 | `MIOSA_ENDPOINT` | API endpoint (overrides config file) |
+| `MIOSA_JSON` | Prefer JSON output for commands that support structured output |
+| `MIOSA_NO_COLOR` | Disable ANSI color output |
 | `MIOSA_DEBUG` | Set to any value to enable debug output |
 
 ## Commands
@@ -198,9 +200,9 @@ miosa connect
 miosa connect my-new-server
 ```
 
-### `miosa ssh <host> [--cmd "..."]`
+### `miosa ssh <computer-or-host> [--cmd "..."]`
 
-Open an interactive PTY terminal session on a host.
+Open an interactive PTY terminal session on a MIOSA Computer. If no Computer matches, the CLI falls back to an OpenComputers host with the same name or ID.
 
 ```bash
 miosa ssh my-mac
@@ -268,14 +270,27 @@ List active tunnels on a host.
 
 Close (revoke) a tunnel.
 
-### `miosa agent <host> "<task>" [--model] [--steps] [--timeout]`
+### `miosa agent <computer> "<task>" [--model] [--max-turns]`
 
-Dispatch an AI agent task. Streams thoughts, tool calls, and results live.
+Start a resumable Computer Use Agent session on a Computer.
 
 ```bash
 miosa agent my-mac "run the test suite and fix any failing tests"
-miosa agent my-mac "update all npm dependencies" --steps 20
+miosa agent my-mac "update all npm dependencies" --max-turns 20
 miosa agent my-mac "optimize the database queries" --model nemotron-3-super
+miosa agent my-mac --resume <session-id> "continue from the last failure"
+miosa agent ls
+miosa agent history <session-id> --computer my-mac
+```
+
+### `miosa completion <shell>`
+
+Print shell completion for `bash`, `zsh`, or `fish`.
+
+```bash
+miosa completion zsh > ~/.zsh/completions/_miosa
+miosa completion bash > ~/.local/share/bash-completion/completions/miosa
+miosa completion fish > ~/.config/fish/completions/miosa.fish
 ```
 
 ### `miosa watch <host>`
 
@@ -1,10 +1,10 @@
 {
   "name": "@miosa/cli",
-  "version": "1.0.8",
+  "version": "1.0.38",
   "description": "MIOSA platform CLI — projects, sandboxes, deploys, databases, more",
   "type": "module",
   "bin": {
-    "miosa": "./dist/bin/miosa.js"
+    "miosa": "dist/bin/miosa.js"
   },
   "scripts": {
     "build": "tsc",
 
@@ -0,0 +1,167 @@
+import fs from "node:fs";
+import path from "node:path";
+
+export const APP_MANIFEST_FILES = [
+  "miosa.app.yml",
+  "miosa.app.yaml",
+  "miosa.app.json",
+] as const;
+
+export interface MiosaAppManifest {
+  template?: string;
+  framework?: string;
+  workdir?: string;
+  install?: string | false;
+  dev?: string;
+  build?: string;
+  start?: string;
+  run?: string;
+  port?: number;
+  output?: string;
+  output_path?: string;
+  readiness?: {
+    path?: string;
+    port?: number;
+  };
+}
+
+export interface LoadedAppManifest {
+  path: string;
+  manifest: MiosaAppManifest;
+}
+
+export function loadAppManifest(dir: string): LoadedAppManifest | null {
+  for (const file of APP_MANIFEST_FILES) {
+    const fullPath = path.join(dir, file);
+    if (!fs.existsSync(fullPath)) continue;
+    const content = fs.readFileSync(fullPath, "utf8");
+    return { path: fullPath, manifest: parseAppManifest(file, content) };
+  }
+  return null;
+}
+
+export function parseAppManifest(
+  filename: string,
+  content: string,
+): MiosaAppManifest {
+  if (filename.endsWith(".json")) {
+    const parsed = JSON.parse(content) as unknown;
+    return normalizeManifest(parsed);
+  }
+  return normalizeManifest(parseSimpleYaml(content));
+}
+
+export function manifestProbePath(manifest?: MiosaAppManifest | null): string | undefined {
+  return manifest?.readiness?.path;
+}
+
+export function manifestPort(manifest?: MiosaAppManifest | null): number | undefined {
+  return numberValue(manifest?.port ?? manifest?.readiness?.port);
+}
+
+export function manifestStartCommand(
+  manifest?: MiosaAppManifest | null,
+): string | undefined {
+  return stringValue(manifest?.dev ?? manifest?.start ?? manifest?.run);
+}
+
+export function manifestRunCommand(
+  manifest?: MiosaAppManifest | null,
+): string | undefined {
+  return stringValue(manifest?.run ?? manifest?.start);
+}
+
+export function manifestBuildCommand(
+  manifest?: MiosaAppManifest | null,
+): string | undefined {
+  return stringValue(manifest?.build);
+}
+
+export function manifestOutputPath(
+  manifest?: MiosaAppManifest | null,
+): string | undefined {
+  return stringValue(manifest?.output_path ?? manifest?.output);
+}
+
+function parseSimpleYaml(content: string): Record<string, unknown> {
+  const root: Record<string, unknown> = {};
+  let section: Record<string, unknown> | null = null;
+
+  for (const rawLine of content.split(/\r?\n/)) {
+    const withoutComment = rawLine.replace(/\s+#.*$/, "");
+    if (!withoutComment.trim()) continue;
+    const indent = withoutComment.match(/^\s*/)?.[0].length ?? 0;
+    const trimmed = withoutComment.trim();
+    const idx = trimmed.indexOf(":");
+    if (idx <= 0) continue;
+
+    const key = trimmed.slice(0, idx).trim();
+    const rawValue = trimmed.slice(idx + 1).trim();
+
+    if (indent === 0) {
+      if (rawValue === "") {
+        section = {};
+        root[key] = section;
+      } else {
+        section = null;
+        root[key] = parseScalar(rawValue);
+      }
+    } else if (section) {
+      section[key] = parseScalar(rawValue);
+    }
+  }
+
+  return root;
+}
+
+function parseScalar(raw: string): unknown {
+  const value = raw.replace(/^['"]|['"]$/g, "");
+  if (value === "false") return false;
+  if (value === "true") return true;
+  if (/^\d+$/.test(value)) return Number(value);
+  return value;
+}
+
+function normalizeManifest(value: unknown): MiosaAppManifest {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return {};
+  const row = value as Record<string, unknown>;
+  const readiness =
+    row["readiness"] && typeof row["readiness"] === "object"
+      ? (row["readiness"] as Record<string, unknown>)
+      : {};
+
+  return {
+    template: stringValue(row["template"] ?? row["template_id"]),
+    framework: stringValue(row["framework"]),
+    workdir: stringValue(row["workdir"] ?? row["workspace"] ?? row["root"]),
+    install:
+      row["install"] === false
+        ? false
+        : stringValue(row["install"] ?? row["install_command"]),
+    dev: stringValue(row["dev"]),
+    build: stringValue(row["build"] ?? row["build_command"]),
+    start: stringValue(row["start"] ?? row["start_command"]),
+    run: stringValue(row["run"] ?? row["run_command"]),
+    port: numberValue(row["port"] ?? readiness["port"]),
+    output: stringValue(row["output"]),
+    output_path: stringValue(row["output_path"]),
+    readiness: {
+      path: stringValue(
+        readiness["path"] ?? row["probe_path"] ?? row["health_check_path"],
+      ),
+      port: numberValue(readiness["port"]),
+    },
+  };
+}
+
+function stringValue(value: unknown): string | undefined {
+  return typeof value === "string" && value.trim() !== ""
+    ? value.trim()
+    : undefined;
+}
+
+function numberValue(value: unknown): number | undefined {
+  if (typeof value === "number" && Number.isInteger(value)) return value;
+  if (typeof value === "string" && /^\d+$/.test(value)) return Number(value);
+  return undefined;
+}