@aman_asmuei/aman 0.3.0 → 0.4.0

package/README.md

@@ -9,7 +9,7 @@
 
 ### Your complete AI companion.
 
-Identity + Memory + Tools + Workflows + Guardrails + Evaluation — one command, any AI.
+Identity + Memory + Tools + Workflows + Guardrails + Skills + Evaluation — setup, deploy, run anywhere.
 
 <br>
 
@@ -20,6 +20,16 @@ Identity + Memory + Tools + Workflows + Guardrails + Evaluation — one command,
 
 ---
 
+<div align="center">
+
+<img src="assets/aman-ecosystem-overview.jpeg" alt="Aman Ecosystem Overview — from v0.7.7 to Full AI Companion Platform" width="100%">
+
+*18+ releases across 5 packages. From a CLI tool to a deployable, browser-accessible, multi-agent AI companion ecosystem.*
+
+</div>
+
+---
+
 ## One Command
 
 ```bash
@@ -47,23 +57,29 @@ Sets up your complete AI ecosystem:
 
 ```
 aman
-├── acore   →  identity     →  who your AI IS
-├── amem    →  memory       →  what your AI KNOWS
-├── akit    →  tools        →  what your AI CAN DO
-├── aflow   →  workflows    →  HOW your AI works
-├── arules  →  guardrails   →  what your AI WON'T do
-└── aeval   →  evaluation   →  how GOOD your AI is
+├── acore       →  identity     →  who your AI IS
+├── amem        →  memory       →  what your AI KNOWS
+├── akit        →  tools        →  what your AI CAN DO
+├── aflow       →  workflows    →  HOW your AI works
+├── arules      →  guardrails   →  what your AI WON'T do
+├── askill      →  skills       →  what your AI MASTERS
+├── aeval       →  evaluation   →  how GOOD your AI is
+├── achannel    →  channels     →  WHERE your AI lives
+└── aman-agent  →  runtime      →  the engine that runs it all
 ```
 
 | Layer | Package | What it does |
 |:------|:--------|:-------------|
-| Identity | [acore](https://github.com/amanasmuei/acore) | Personality, values, relationship memory |
-| Memory | [amem](https://github.com/amanasmuei/amem) | Automated knowledge storage (MCP) |
+| Identity | [acore](https://github.com/amanasmuei/acore) | Personality, values, appearance, relationship memory |
+| Memory | [amem](https://github.com/amanasmuei/amem) | Automated knowledge storage with semantic search (MCP) |
 | Tools | [akit](https://github.com/amanasmuei/akit) | 15 portable AI tools (MCP + manual fallback) |
 | Workflows | [aflow](https://github.com/amanasmuei/aflow) | Reusable AI workflows (code review, bug fix, etc.) |
 | Guardrails | [arules](https://github.com/amanasmuei/arules) | Safety boundaries and permissions |
+| Skills | [askill](https://github.com/amanasmuei/askill) | Domain expertise with leveling (testing, security, etc.) |
 | Evaluation | [aeval](https://github.com/amanasmuei/aeval) | Relationship tracking and session logging |
-| **Unified** | **[aman](https://github.com/amanasmuei/aman)** | **One command to set up everything** |
+| Channels | [achannel](https://github.com/amanasmuei/achannel) | Telegram, Discord, webhook server |
+| Runtime | [aman-agent](https://github.com/amanasmuei/aman-agent) | Standalone AI companion CLI |
+| **Unified** | **[aman](https://github.com/amanasmuei/aman)** | **Setup + Deploy — one command for everything** |
 
 Each package works independently. `aman` is the front door.
 
@@ -75,7 +91,8 @@ Each package works independently. `aman` is the front door.
 |:--------|:------------|
 | `aman` | First run: setup. After that: show status |
 | `aman setup` | Set up the full ecosystem |
-| `aman status` | View ecosystem status (all 6 layers) |
+| `aman status` | View ecosystem status (all layers) |
+| `aman deploy` | Deploy your AI anywhere (Docker, Ollama, systemd) |
 
 After setup, use the individual CLIs for detailed management:
 
@@ -114,6 +131,65 @@ $ aman status
 
 ---
 
+## Deploy Anywhere
+
+Make your AI companion always-on — accessible from terminal, browser, Telegram, or Discord.
+
+```bash
+npx @aman_asmuei/aman deploy
+```
+
+Interactive wizard with 4 deployment methods:
+
+### Docker Compose (VPS / Home Server)
+
+```bash
+aman deploy          # select "Docker Compose", enter API key
+docker compose up -d # → running on port 3000
+```
+
+Packages the full ecosystem in one container: aman-agent + achannel (Telegram/Discord/webhook) + aman-mcp + amem.
+
+### Docker + Ollama (Fully Local)
+
+```bash
+aman deploy          # select "Docker + Ollama"
+docker compose up -d # → aman + Ollama, zero cloud dependency
+```
+
+No API key needed. Runs on Raspberry Pi 4/5 (ARM64), any Linux, macOS.
+
+### Systemd Service (Bare Metal / Raspberry Pi)
+
+```bash
+aman deploy          # select "Systemd service"
+# Shows step-by-step install for bare metal Linux
+```
+
+### What's in the Docker Image
+
+| Component | What it does |
+|:---|:---|
+| **aman-agent** | Interactive CLI companion |
+| **achannel** | Telegram, Discord, webhook server |
+| **aman-mcp** | MCP bridge for all ecosystem layers |
+| **amem** | Persistent memory with SQLite |
+
+### Environment Variables
+
+| Variable | Description |
+|:---|:---|
+| `ANTHROPIC_API_KEY` | Anthropic API key |
+| `OPENAI_API_KEY` | OpenAI API key (alternative) |
+| `AMAN_AI_NAME` | Your AI's name (default: Aman) |
+| `AMAN_MODEL` | LLM model (default: claude-sonnet-4-6) |
+| `TELEGRAM_BOT_TOKEN` | Optional — Telegram bot |
+| `DISCORD_BOT_TOKEN` | Optional — Discord bot |
+
+All data persists in Docker volumes (identity, memory, config, rules, workflows, skills, eval).
+
+---
+
 ## How It All Connects
 
 Every layer is a markdown file. acore auto-injects all of them into your AI's system prompt:
@@ -151,6 +227,6 @@ ChatGPT, Claude, Claude Code, Cursor, Windsurf, Gemini, Ollama, and any AI that
 
 <div align="center">
 
-**One command. 6 layers. Any AI. Your companion.**
+**Setup. Deploy. Run anywhere. Your AI companion.**
 
 </div>

package/dist/index.js

@@ -32,8 +32,8 @@ function detectPlatform(cwd) {
       const raw = fs.readFileSync(configPath, "utf-8");
       const parsed = JSON.parse(raw);
       if (typeof parsed.platform === "string") {
-        const p4 = parsed.platform;
-        if (p4 === "claude-code" || p4 === "cursor" || p4 === "windsurf") return p4;
+        const p5 = parsed.platform;
+        if (p5 === "claude-code" || p5 === "cursor" || p5 === "windsurf") return p5;
       }
     } catch {
     }
@@ -836,9 +836,132 @@ function copyDeployFile(pkgDir, destDir, filename) {
   }
 }
 
+// src/commands/showcase.ts
+import * as p4 from "@clack/prompts";
+import pc4 from "picocolors";
+import { spawnSync } from "child_process";
+var SHOWCASE_PACKAGE = "@aman_asmuei/aman-showcase";
+var CATEGORIES = {
+  health: "Health",
+  business: "Business",
+  learning: "Learning",
+  lifestyle: "Lifestyle",
+  monitoring: "Monitoring"
+};
+var EMBEDDED_MANIFEST = [
+  { name: "rutin", title: "Rutin \u2014 Medication Reminder", description: "Daily medication reminders for elderly parents and family.", category: "health", language: "ms", channels: ["telegram"] },
+  { name: "kedai", title: "Kedai \u2014 Small Business Assistant", description: "Transaction tracking for restaurants, salons, and laundries.", category: "business", language: "en+ms", channels: ["telegram"] },
+  { name: "monitor", title: "Monitor \u2014 AI Watchdog", description: "Price and website monitoring with real-time alerts.", category: "monitoring", language: "en", channels: ["telegram", "discord"] },
+  { name: "bahasa", title: "Bahasa \u2014 Language Tutor", description: "Malay/English language learning with structured curriculum.", category: "learning", language: "en+ms", channels: ["telegram"] },
+  { name: "quran", title: "Quran \u2014 Arabic Vocabulary", description: "Quranic Arabic lessons with 12 structured vocabulary units.", category: "learning", language: "en+ms", channels: ["telegram"] },
+  { name: "fitness", title: "Fitness \u2014 Personal Trainer", description: "Workout tracking with progressive overload and form guidance.", category: "health", language: "en", channels: ["telegram"] },
+  { name: "freelancer", title: "Freelancer \u2014 Business Tracker", description: "Invoice and client tracking for independent workers.", category: "business", language: "en", channels: ["telegram"] },
+  { name: "team", title: "Team \u2014 Collaboration Assistant", description: "Standups, task tracking, and team memory.", category: "business", language: "en", channels: ["telegram", "discord"] },
+  { name: "money", title: "Money \u2014 Finance Tracker", description: "Personal finance and budget monitoring.", category: "lifestyle", language: "en", channels: ["telegram"] },
+  { name: "feed", title: "Feed \u2014 News Companion", description: "Personalized news aggregation and daily digests.", category: "lifestyle", language: "en", channels: ["telegram"] },
+  { name: "support", title: "Support \u2014 Customer Assistant", description: "Customer support with context memory and escalation.", category: "business", language: "en", channels: ["telegram", "webhook"] },
+  { name: "iot", title: "IoT \u2014 Smart Monitor", description: "Sensor monitoring with anomaly detection and threshold alerts.", category: "monitoring", language: "en", channels: ["telegram"] },
+  { name: "muslim", title: "Muslim \u2014 Daily Companion", description: "Islamic companion with prayer times, hadith, and du'a.", category: "lifestyle", language: "en+ms", channels: ["telegram"] }
+];
+function fetchManifest() {
+  const result = spawnSync(
+    "npx",
+    ["-y", SHOWCASE_PACKAGE, "list-json"],
+    { encoding: "utf8", timeout: 3e4 }
+  );
+  if (result.status !== 0 || !result.stdout.trim()) {
+    return EMBEDDED_MANIFEST;
+  }
+  try {
+    return JSON.parse(result.stdout);
+  } catch {
+    return EMBEDDED_MANIFEST;
+  }
+}
+async function showcaseCommand(nameArg, opts = {}) {
+  p4.intro(pc4.bold("aman showcase") + " \u2014 try any AI companion in one command");
+  const manifest = fetchManifest();
+  if (opts.list) {
+    console.log("\nAvailable showcases:\n");
+    const byCategory = manifest.reduce((acc, s) => {
+      (acc[s.category] ??= []).push(s);
+      return acc;
+    }, {});
+    for (const [cat, entries] of Object.entries(byCategory)) {
+      console.log(pc4.bold(CATEGORIES[cat] ?? cat));
+      for (const e of entries) {
+        console.log(`  ${pc4.cyan(e.name.padEnd(14))} ${e.title}`);
+      }
+      console.log();
+    }
+    return;
+  }
+  let name = nameArg;
+  if (!name) {
+    const choice = await p4.select({
+      message: "Which showcase do you want to try?",
+      options: manifest.map((s) => ({
+        value: s.name,
+        label: s.title,
+        hint: s.description
+      }))
+    });
+    if (p4.isCancel(choice)) {
+      p4.cancel("Cancelled.");
+      process.exit(0);
+    }
+    name = choice;
+  }
+  const entry = manifest.find((s) => s.name === name);
+  if (!entry) {
+    p4.log.error(
+      `Unknown showcase: "${name}". Run ${pc4.cyan("aman showcase --list")} to see available options.`
+    );
+    process.exit(1);
+  }
+  if (opts.dryRun) {
+    p4.log.info(`Dry run for ${pc4.bold(entry.title)}`);
+    spawnSync("npx", ["-y", SHOWCASE_PACKAGE, "install", name, "--dry-run"], {
+      encoding: "utf8",
+      stdio: "inherit",
+      timeout: 3e4
+    });
+    return;
+  }
+  const confirmed = await p4.confirm({
+    message: `Install ${pc4.bold(entry.title)}? Existing ~/.acore, ~/.aflow, ~/.arules, ~/.askill files will be backed up.`,
+    initialValue: true
+  });
+  if (p4.isCancel(confirmed) || !confirmed) {
+    p4.cancel("Cancelled.");
+    process.exit(0);
+  }
+  const spinner2 = p4.spinner();
+  spinner2.start("Installing showcase files...");
+  const result = spawnSync("npx", ["-y", SHOWCASE_PACKAGE, "install", name], {
+    encoding: "utf8",
+    timeout: 6e4
+  });
+  if (result.status !== 0) {
+    spinner2.stop("Installation failed.");
+    p4.log.error(result.stderr || "Unknown error");
+    process.exit(1);
+  }
+  spinner2.stop("Showcase installed!");
+  p4.note(
+    [
+      `1. Copy ${pc4.cyan(".env.example")} to ${pc4.cyan(".env")}`,
+      `2. Fill in your ${pc4.yellow("ANTHROPIC_API_KEY")} and ${pc4.yellow("TELEGRAM_BOT_TOKEN")}`,
+      `3. Run: ${pc4.green("npx @aman_asmuei/achannel serve")}`
+    ].join("\n"),
+    "Next steps"
+  );
+  p4.outro(`${pc4.green("\u2713")} ${entry.title} is ready!`);
+}
+
 // src/index.ts
 var program = new Command();
-program.name("aman").description("Your complete AI companion \u2014 identity, memory, and tools in one command").version("0.3.0").action(() => {
+program.name("aman").description("Your complete AI companion \u2014 identity, memory, and tools in one command").version("0.4.0").action(() => {
   const ecosystem = detectEcosystem();
   if (ecosystem.acore.installed) {
     statusCommand();
@@ -849,4 +972,7 @@ program.name("aman").description("Your complete AI companion \u2014 identity, me
 program.command("setup").description("Set up your AI companion (identity + memory + tools)").action(() => setupCommand());
 program.command("status").description("View your full ecosystem status").action(() => statusCommand());
 program.command("deploy").description("Deploy your AI companion (Docker, systemd, or cloud)").action(() => deployCommand());
+program.command("showcase [name]").description("Set up a showcase AI companion (rutin, kedai, monitor, ...)").option("--dry-run", "preview files without installing").option("--list", "list all available showcases").action(
+  (name, opts) => showcaseCommand(name, opts)
+);
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aman_asmuei/aman",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Your complete AI companion — identity, memory, and tools in one command",
   "type": "module",
   "bin": {