context101-cli 0.1.2 → 0.1.3

package/README.md

@@ -0,0 +1,52 @@
+# context101-cli
+
+your context. every agent.
+
+Thin self-host CLI for [Context101](https://github.com/jginorio/context101) — a wrapper around Amazon Bedrock Knowledge Bases. Self-host now; hosted later (not there yet). Alpha / trusted-team.
+
+This is the AWS front door: init, deploy, list, destroy, config. Not a wiki app.
+
+**`npx context101` (unscoped) is Context7's MCP — not this tool.** Use `context101-cli`.
+
+## Install
+
+```bash
+npm i -g context101-cli
+context101 <cmd>
+```
+
+or
+
+```bash
+npx context101-cli@latest <cmd>
+```
+
+## Commands
+
+| Command | What it does |
+| --- | --- |
+| `context101 init` | write deploy-env; TTY asks to deploy |
+| `context101 deploy` | deploy the AWS stack |
+| `context101 list` | list Context101 CloudFormation stacks |
+| `context101 destroy <name>` | tear down a listed stack |
+| `context101 config` | show deploy-env keys (values redacted) |
+| `context101 config set KEY=value` | write one key (chmod 600; value is not printed) |
+| `context101 help` | list commands |
+
+`list`, `help`, and `destroy --dry-run` work without a checkout.
+
+```bash
+context101 list
+context101 help
+context101 destroy Context101Stack --dry-run
+```
+
+## Name collision
+
+The publishable package is **context101-cli**. The bin name is `context101`.
+
+`npx context101` downloads Context7's MCP from npm. Unrelated.
+
+## Repo
+
+https://github.com/jginorio/context101

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "context101-cli",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "private": false,
-  "description": "Context101 self-host CLI. Use `npx context101-cli` or the `context101` bin. The public npm package named context101 is Context7's MCP, not this tool.",
+  "description": "Context101 self-host CLI — your context. every agent. Use `npx context101-cli` or the `context101` bin. Unscoped `npx context101` is Context7's MCP, not this tool.",
+  "license": "MIT",
   "type": "module",
   "bin": {
     "context101": "./bin/context101.js"
@@ -11,6 +12,22 @@
     "bin",
     "src"
   ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jginorio/context101.git"
+  },
+  "homepage": "https://github.com/jginorio/context101",
+  "bugs": {
+    "url": "https://github.com/jginorio/context101/issues"
+  },
+  "keywords": [
+    "context101",
+    "cli",
+    "knowledge-base",
+    "bedrock",
+    "mcp",
+    "self-host"
+  ],
   "scripts": {
     "test": "node --test test/*.test.js"
   },

package/src/main.js

@@ -3,7 +3,7 @@ import { runConfig } from "./config.js";
 import { runDeploy } from "./deploy.js";
 import { runInit } from "./init.js";
 import { runDestroy, runList } from "./stacks.js";
-import { writers } from "./style.js";
+import { banner, writers } from "./style.js";
 
 export async function main(argv, ctx) {
   const io = writers(ctx);
@@ -22,6 +22,7 @@ export async function main(argv, ctx) {
   if (opts.help || opts.command === "help") {
     const topic =
       opts.helpTopic ?? (opts.command !== "help" ? opts.command : null);
+    banner(ctx);
     io.write(helpText(topic));
     return 0;
   }

package/src/stacks.js

@@ -44,21 +44,31 @@ export function listDeployments({ exec, env, region = SMOOTH_REGION } = {}) {
   }
 }
 
-export function formatDeployments(stacks, { region = SMOOTH_REGION } = {}) {
+export function statusTone(status, colors = {}) {
+  const s = String(status);
+  if (/FAIL|ROLLBACK/i.test(s)) return colors.red ?? "";
+  if (/IN_PROGRESS|PENDING|REVIEW/i.test(s)) return colors.violet ?? "";
+  if (/COMPLETE/i.test(s)) return colors.magenta ?? "";
+  return colors.violet ?? "";
+}
+
+export function formatDeployments(stacks, { region = SMOOTH_REGION, colors } = {}) {
+  const c = colors ?? { magenta: "", violet: "", dim: "", red: "", bold: "", reset: "" };
   if (!stacks.length) {
     return [`No Context101 deployments in ${region}.`, `Next: ${DEPLOY_CLI}`].join("\n");
   }
   const nameW = Math.max(4, ...stacks.map((s) => String(s.StackName).length));
   const statusW = Math.max(6, ...stacks.map((s) => String(s.StackStatus).length));
   const lines = [
-    `Context101 deployments in ${region}`,
+    `${c.dim}Context101 deployments in ${region}${c.reset}`,
     "",
-    `${"NAME".padEnd(nameW)}  ${"STATUS".padEnd(statusW)}  UPDATED`,
+    `${c.dim}${"NAME".padEnd(nameW)}  ${"STATUS".padEnd(statusW)}  UPDATED${c.reset}`,
   ];
   for (const stack of stacks) {
     const updated = stack.LastUpdatedTime || stack.CreationTime || "";
+    const tone = statusTone(stack.StackStatus, c);
     lines.push(
-      `${String(stack.StackName).padEnd(nameW)}  ${String(stack.StackStatus).padEnd(statusW)}  ${updated}`
+      `${String(stack.StackName).padEnd(nameW)}  ${tone}${String(stack.StackStatus).padEnd(statusW)}${c.reset}  ${c.dim}${updated}${c.reset}`
     );
   }
   return lines.join("\n");
@@ -80,7 +90,7 @@ export async function runList(opts, ctx) {
     io.err(listed.error);
     return 1;
   }
-  io.write(formatDeployments(listed.stacks, { region: SMOOTH_REGION }));
+  io.write(formatDeployments(listed.stacks, { region: SMOOTH_REGION, colors: io.c }));
   io.write("");
   return 0;
 }
@@ -113,7 +123,7 @@ export async function runDestroy(opts, ctx) {
     return 1;
   }
 
-  io.write(formatDeployments(listed.stacks, { region: SMOOTH_REGION }));
+  io.write(formatDeployments(listed.stacks, { region: SMOOTH_REGION, colors: io.c }));
   io.write("");
 
   const known = listed.stacks.some((stack) => stack.StackName === stackName);

package/src/style.js

@@ -1,19 +1,40 @@
+export const TAGLINE = "your context. every agent.";
+
+const MAGENTA = [184, 85, 201];
+const VIOLET = [139, 92, 246];
+const DUSTY = [168, 158, 180];
+const MAGENTA_256 = 170;
+const VIOLET_256 = 99;
+const DUSTY_256 = 139;
+
 function enabled(stream) {
   if (process.env.NO_COLOR) return false;
   if (process.env.FORCE_COLOR === "0") return false;
   return Boolean(stream && stream.isTTY);
 }
 
+function truecolor() {
+  const colorterm = String(process.env.COLORTERM || "").toLowerCase();
+  if (colorterm === "truecolor" || colorterm === "24bit") return true;
+  const term = String(process.env.TERM || "").toLowerCase();
+  return term.includes("truecolor") || term.includes("direct");
+}
+
+function fg(rgb, fallback256) {
+  if (truecolor()) return `\x1b[38;2;${rgb[0]};${rgb[1]};${rgb[2]}m`;
+  return `\x1b[38;5;${fallback256}m`;
+}
+
 export function palette(stream = process.stdout) {
   if (!enabled(stream)) {
-    return { red: "", green: "", yellow: "", bold: "", dim: "", reset: "" };
+    return { magenta: "", violet: "", dim: "", red: "", bold: "", reset: "" };
   }
   return {
+    magenta: fg(MAGENTA, MAGENTA_256),
+    violet: fg(VIOLET, VIOLET_256),
+    dim: fg(DUSTY, DUSTY_256),
     red: "\x1b[31m",
-    green: "\x1b[32m",
-    yellow: "\x1b[33m",
     bold: "\x1b[1m",
-    dim: "\x1b[2m",
     reset: "\x1b[0m",
   };
 }
@@ -28,10 +49,10 @@ export function writers(io) {
       out.write(`${line}\n`);
     },
     ok(msg) {
-      out.write(`${c.green}✓${c.reset} ${msg}\n`);
+      out.write(`${c.magenta}✓${c.reset} ${msg}\n`);
     },
     warn(msg) {
-      err.write(`${c.yellow}!${c.reset} ${msg}\n`);
+      err.write(`${c.violet}!${c.reset} ${msg}\n`);
     },
     err(msg) {
       err.write(`${c.red}✗${c.reset} ${msg}\n`);
@@ -48,7 +69,7 @@ export function writers(io) {
 export function banner(io) {
   const { c, write } = writers(io);
   write();
-  write(`${c.bold}Context101${c.reset}`);
-  write(`${c.dim}self-host setup — web/ + CDK + MCP on your AWS account${c.reset}`);
+  write(`${c.bold}${c.magenta}Context101${c.reset}`);
+  write(`${c.dim}${TAGLINE}${c.reset}`);
   write();
 }