@aman_asmuei/aman 0.3.1 → 0.5.0

package/README.md

@@ -20,6 +20,16 @@ Identity + Memory + Tools + Workflows + Guardrails + Skills + Evaluation — set
 
 ---
 
+<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

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 p6 = parsed.platform;
+        if (p6 === "claude-code" || p6 === "cursor" || p6 === "windsurf") return p6;
       }
     } catch {
     }
@@ -836,9 +836,198 @@ 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/commands/here.ts
+import * as p5 from "@clack/prompts";
+import pc5 from "picocolors";
+import fs7 from "fs";
+import path5 from "path";
+async function hereCommand(opts = {}) {
+  const cwd = process.cwd();
+  const acoreDir = path5.join(cwd, ".acore");
+  const contextPath = path5.join(acoreDir, "context.md");
+  const configPath = path5.join(acoreDir, "config.json");
+  if (fs7.existsSync(contextPath) && !opts.force) {
+    p5.intro(pc5.bold("aman here") + " \u2014 project context card");
+    const overwrite = await p5.confirm({
+      message: `${pc5.dim(".acore/context.md")} already exists. Overwrite?`,
+      initialValue: false
+    });
+    if (p5.isCancel(overwrite) || overwrite === false) {
+      p5.outro(pc5.yellow("Skipped. Use --force to overwrite without prompt."));
+      return;
+    }
+  }
+  const stack = detectStack() || "unknown";
+  const platform = detectPlatform();
+  const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  fs7.mkdirSync(acoreDir, { recursive: true });
+  const contextContent = `## Work
+- Stack: ${stack}
+- Domain:
+- Focus:
+
+## Session
+- Last updated: ${today}
+- Resume: [starting fresh]
+- Active topics: []
+- Recent decisions: []
+- Temp notes: []
+
+## Project Patterns
+- [observations specific to this project \u2014 built over time]
+`;
+  fs7.writeFileSync(contextPath, contextContent, "utf-8");
+  if (fs7.existsSync(configPath)) {
+    try {
+      const existing = JSON.parse(fs7.readFileSync(configPath, "utf-8"));
+      if (typeof existing.platform !== "string" || existing.platform === "") {
+        existing.platform = platform || "other";
+        fs7.writeFileSync(configPath, JSON.stringify(existing, null, 2) + "\n", "utf-8");
+      }
+    } catch {
+      const fresh = { platform: platform || "other" };
+      fs7.writeFileSync(configPath, JSON.stringify(fresh, null, 2) + "\n", "utf-8");
+    }
+  } else {
+    const fresh = { platform: platform || "other" };
+    fs7.writeFileSync(configPath, JSON.stringify(fresh, null, 2) + "\n", "utf-8");
+  }
+  if (opts.force) {
+    return;
+  }
+  p5.intro(pc5.bold("aman here") + " \u2014 project context card");
+  p5.log.success(`Wrote ${pc5.dim(".acore/context.md")} (stack: ${stack})`);
+  p5.log.info("Edit it as you work. It is read by aman-claude-code on every session start,");
+  p5.log.info(`and embedded into copilot-instructions.md when you run ${pc5.bold("aman-copilot init")}.`);
+  p5.outro(pc5.green("Done."));
+}
+
 // 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.1").action(() => {
+program.name("aman").description("Your complete AI companion \u2014 identity, memory, and tools in one command").version("0.5.0").action(() => {
   const ecosystem = detectEcosystem();
   if (ecosystem.acore.installed) {
     statusCommand();
@@ -849,4 +1038,8 @@ 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.command("here").description("Write a project context card (.acore/context.md) for the current directory").option("--force", "overwrite existing card without prompt").action((opts) => hereCommand(opts));
 program.parse();

package/package.json

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