@itznexus/itznexus-cli 0.0.0

package/dist/lib/auto-update.js

@@ -0,0 +1,96 @@
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { execSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const PKG_ROOT = path.resolve(__dirname, "..", "..");
+const CACHE_DIR = path.join(os.homedir(), ".itznexus");
+const CACHE_FILE = path.join(CACHE_DIR, "last-update-check");
+const CHECK_INTERVAL_MS = 60 * 60 * 1000; // 1 hour
+const PKG_NAME = "@itznexus/itznexus-cli";
+/**
+ * Running from source via npm link — .git exists in the package root.
+ * In this case, skip auto-update entirely.
+ */
+function isDevMode() {
+    try {
+        fs.statSync(path.join(PKG_ROOT, ".git"));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function getInstalledVersion() {
+    const pkgPath = path.join(PKG_ROOT, "package.json");
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+    return pkg.version;
+}
+function getLastCheckTime() {
+    try {
+        const raw = fs.readFileSync(CACHE_FILE, "utf-8").trim();
+        return parseInt(raw, 10) || 0;
+    }
+    catch {
+        return 0;
+    }
+}
+function saveCheckTime() {
+    if (!fs.existsSync(CACHE_DIR)) {
+        fs.mkdirSync(CACHE_DIR, { recursive: true });
+    }
+    fs.writeFileSync(CACHE_FILE, String(Date.now()));
+}
+function getLatestVersion() {
+    try {
+        const output = execSync(`npm view ${PKG_NAME} version`, {
+            encoding: "utf-8",
+            timeout: 10_000,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        return output.trim();
+    }
+    catch {
+        return null;
+    }
+}
+function performUpdate() {
+    try {
+        execSync(`npm install -g ${PKG_NAME}@latest`, {
+            timeout: 60_000,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check for updates and auto-install if a newer version is available.
+ * Skips entirely in dev mode (npm link) or if checked recently.
+ * Runs silently — never blocks or errors the main command.
+ */
+export function checkForUpdates() {
+    try {
+        if (isDevMode())
+            return;
+        const lastCheck = getLastCheckTime();
+        if (Date.now() - lastCheck < CHECK_INTERVAL_MS)
+            return;
+        saveCheckTime();
+        const installed = getInstalledVersion();
+        const latest = getLatestVersion();
+        if (!latest || latest === installed)
+            return;
+        const updated = performUpdate();
+        if (updated) {
+            console.error(`[itznexus] Updated ${installed} → ${latest}`);
+        }
+    }
+    catch {
+        // Never let update logic break the CLI
+    }
+}
+//# sourceMappingURL=auto-update.js.map

package/dist/lib/auto-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-update.js","sourceRoot":"","sources":["../../src/lib/auto-update.ts"],"names":[],"mappings":"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"}

package/dist/lib/config.d.ts

@@ -0,0 +1,7 @@
+type Config = {
+    apiUrl: string;
+    apiKey?: string;
+};
+export declare function loadConfig(): Config;
+export declare function saveConfig(config: Partial<Config>): void;
+export {};

package/dist/lib/config.js

@@ -0,0 +1,28 @@
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+const CONFIG_DIR = path.join(os.homedir(), ".itznexus");
+const CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
+function defaultConfig() {
+    return {
+        apiUrl: process.env.ITZNEXUS_API_URL ?? "http://localhost:4100",
+    };
+}
+export function loadConfig() {
+    const defaults = defaultConfig();
+    if (!fs.existsSync(CONFIG_FILE)) {
+        return defaults;
+    }
+    const raw = fs.readFileSync(CONFIG_FILE, "utf-8");
+    const stored = JSON.parse(raw);
+    return { ...defaults, ...stored };
+}
+export function saveConfig(config) {
+    const current = loadConfig();
+    const merged = { ...current, ...config };
+    if (!fs.existsSync(CONFIG_DIR)) {
+        fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(merged, null, 2) + "\n");
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;AACxD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAOzD,SAAS,aAAa;IACpB,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,uBAAuB;KAChE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IAEjC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoB,CAAC;IAElD,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAuB;IAChD,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;IAEzC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACxE,CAAC"}

package/dist/lib/format.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Print a list of records as a table or JSON.
+ */
+export declare function printList(records: Record<string, unknown>[], columns: {
+    key: string;
+    label: string;
+    width?: number;
+}[], opts: {
+    json?: boolean;
+}): void;
+/**
+ * Print a single record as key/value pairs or JSON.
+ */
+export declare function printDetail(record: Record<string, unknown>, fields: {
+    key: string;
+    label: string;
+}[], opts: {
+    json?: boolean;
+}): void;
+/**
+ * Handle API or network errors consistently.
+ */
+export declare function handleError(err: unknown): never;

package/dist/lib/format.js

@@ -0,0 +1,59 @@
+import chalk from "chalk";
+import { ApiError } from "./api.js";
+/**
+ * Print a list of records as a table or JSON.
+ */
+export function printList(records, columns, opts) {
+    if (opts.json) {
+        console.log(JSON.stringify(records, null, 2));
+        return;
+    }
+    if (records.length === 0) {
+        console.log(chalk.dim("No results."));
+        return;
+    }
+    // Header
+    const header = columns.map((c) => c.label.padEnd(c.width ?? 20)).join("  ");
+    console.log(chalk.dim(header));
+    console.log(chalk.dim("─".repeat(header.length)));
+    // Rows
+    for (const record of records) {
+        const row = columns
+            .map((c) => {
+            const val = record[c.key];
+            const str = val == null ? "-" : String(val);
+            return str.padEnd(c.width ?? 20);
+        })
+            .join("  ");
+        console.log(row);
+    }
+    console.log(chalk.dim(`\n${records.length} result${records.length !== 1 ? "s" : ""}`));
+}
+/**
+ * Print a single record as key/value pairs or JSON.
+ */
+export function printDetail(record, fields, opts) {
+    if (opts.json) {
+        console.log(JSON.stringify(record, null, 2));
+        return;
+    }
+    const maxLabel = Math.max(...fields.map((f) => f.label.length));
+    for (const field of fields) {
+        const val = record[field.key];
+        const str = val == null ? chalk.dim("-") : String(val);
+        console.log(`  ${field.label.padEnd(maxLabel + 1)} ${str}`);
+    }
+}
+/**
+ * Handle API or network errors consistently.
+ */
+export function handleError(err) {
+    if (err instanceof ApiError) {
+        console.error(chalk.red("✗"), `API error: ${err.message}`);
+    }
+    else {
+        console.error(chalk.red("✗"), "Cannot reach API. Is it running?");
+    }
+    process.exit(1);
+}
+//# sourceMappingURL=format.js.map

package/dist/lib/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/lib/format.ts"],"names":[],"mappings":"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"}

package/dist/skills/claude-code/itznexus-auth.md

@@ -0,0 +1,61 @@
+---
+name: itznexus-auth
+description: "Manage authentication via the ITzNexus CLI"
+---
+
+# itznexus auth
+
+Manage authentication. All commands return JSON when called with `--json`.
+
+## Response Shape
+
+All commands output JSON to stdout:
+- **Success:** the created/updated/fetched object(s) directly
+- **Error:** process exits with code 1 and prints an error message to stderr
+
+## When to Use
+
+Use this skill when you need to create, read, update, or delete **auth** records in ITzNexus. Always use the `--json` flag so output is machine-parseable.
+
+## Commands
+
+### login
+
+Configure API key authentication.
+
+```bash
+itznexus auth login [--api-url] [--api-key] --json
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--api-url` | no | API base URL |
+| `--api-key` | no | API key (sk-itznx_...) |
+
+### status
+
+Show current authentication status.
+
+```bash
+itznexus auth status --json
+```
+
+### logout
+
+Remove stored API key.
+
+```bash
+itznexus auth logout --json
+```
+
+## Example Flows
+
+**Check authentication:**
+```bash
+itznexus auth status --json
+```
+## Important
+
+- Always pass `--json` for machine-readable output.
+- IDs are UUIDs. Get them from `list` or `create` responses.
+- The CLI authenticates via API key stored in `~/.itznexus/config.json`. Run `itznexus auth status --json` to verify.

package/dist/skills/claude-code/itznexus-company.md

@@ -0,0 +1,143 @@
+---
+name: itznexus-company
+description: "Manage companies via the ITzNexus CLI"
+---
+
+# itznexus company
+
+Manage companies. All commands return JSON when called with `--json`.
+
+## Response Shape
+
+All commands output JSON to stdout:
+- **Success:** the created/updated/fetched object(s) directly
+- **Error:** process exits with code 1 and prints an error message to stderr
+
+## When to Use
+
+Use this skill when you need to create, read, update, or delete **company** records in ITzNexus. Always use the `--json` flag so output is machine-parseable.
+
+## Commands
+
+### list
+
+List all companies.
+
+```bash
+itznexus company list [--status] [--search] --json
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--status` | no | Filter by status (active, inactive, churned) |
+| `--search` | no | Search by name |
+
+### get
+
+Get company details.
+
+```bash
+itznexus company get <id> --json
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `id` | yes | Company ID |
+
+### create
+
+Create a new company.
+
+```bash
+itznexus company create --name <name> [--website] [--referral] [--status] [--notes] --json
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--name` | yes | Company name |
+| `--website` | no | Website URL |
+| `--referral` | no | Referral source |
+| `--status` | no | Status (active, inactive, churned) (default: `"active"`) |
+| `--notes` | no | Notes (markdown) |
+
+### update
+
+Update a company.
+
+```bash
+itznexus company update <id> [--name] [--website] [--referral] [--status] [--notes] --json
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `id` | yes | Company ID |
+| `--name` | no | Company name |
+| `--website` | no | Website URL |
+| `--referral` | no | Referral source |
+| `--status` | no | Status (active, inactive, churned) |
+| `--notes` | no | Notes (markdown) |
+
+### delete
+
+Delete a company.
+
+```bash
+itznexus company delete <id> --json
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `id` | yes | Company ID |
+
+### link-contact
+
+Link a contact to this company.
+
+```bash
+itznexus company link-contact <companyId> --contact <contactId> [--role] --json
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `companyId` | yes | Company ID |
+| `--contact` | yes | Contact ID to link |
+| `--role` | no | Role at this company (e.g. CTO) |
+
+### unlink-contact
+
+Unlink a contact from this company.
+
+```bash
+itznexus company unlink-contact <companyId> --contact <contactId> --json
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `companyId` | yes | Company ID |
+| `--contact` | yes | Contact ID to unlink |
+
+## Example Flows
+
+**Create a company and link a contact:**
+```bash
+# Create the company
+itznexus company create --name "Acme Corp" --website "https://acme.com" --json
+
+# Create or find a contact, then link them
+itznexus company link-contact <companyId> --contact <contactId> --role "CTO" --json
+```
+
+**Find a company by name:**
+```bash
+itznexus company list --search "Acme" --json
+```
+
+**Change a company status to churned:**
+```bash
+itznexus company update <companyId> --status churned --json
+```
+## Important
+
+- Always pass `--json` for machine-readable output.
+- IDs are UUIDs. Get them from `list` or `create` responses.
+- The CLI authenticates via API key stored in `~/.itznexus/config.json`. Run `itznexus auth status --json` to verify.

package/dist/skills/claude-code/itznexus-contact.md

@@ -0,0 +1,109 @@
+---
+name: itznexus-contact
+description: "Manage contacts via the ITzNexus CLI"
+---
+
+# itznexus contact
+
+Manage contacts. All commands return JSON when called with `--json`.
+
+## Response Shape
+
+All commands output JSON to stdout:
+- **Success:** the created/updated/fetched object(s) directly
+- **Error:** process exits with code 1 and prints an error message to stderr
+
+## When to Use
+
+Use this skill when you need to create, read, update, or delete **contact** records in ITzNexus. Always use the `--json` flag so output is machine-parseable.
+
+## Commands
+
+### list
+
+List all contacts.
+
+```bash
+itznexus contact list [--search] --json
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--search` | no | Search by name |
+
+### get
+
+Get contact details.
+
+```bash
+itznexus contact get <id> --json
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `id` | yes | Contact ID |
+
+### create
+
+Create a new contact.
+
+```bash
+itznexus contact create --name <name> [--email] [--phone] [--notes] --json
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--name` | yes | Contact name |
+| `--email` | no | Email address |
+| `--phone` | no | Phone number |
+| `--notes` | no | Notes (markdown) |
+
+### update
+
+Update a contact.
+
+```bash
+itznexus contact update <id> [--name] [--email] [--phone] [--notes] --json
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `id` | yes | Contact ID |
+| `--name` | no | Contact name |
+| `--email` | no | Email address |
+| `--phone` | no | Phone number |
+| `--notes` | no | Notes (markdown) |
+
+### delete
+
+Delete a contact.
+
+```bash
+itznexus contact delete <id> --json
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `id` | yes | Contact ID |
+
+## Example Flows
+
+**Create a contact:**
+```bash
+itznexus contact create --name "Jane Smith" --email "jane@example.com" --json
+```
+
+**Find contacts by name:**
+```bash
+itznexus contact list --search "Jane" --json
+```
+
+**Get full details including linked companies:**
+```bash
+itznexus contact get <contactId> --json
+```
+## Important
+
+- Always pass `--json` for machine-readable output.
+- IDs are UUIDs. Get them from `list` or `create` responses.
+- The CLI authenticates via API key stored in `~/.itznexus/config.json`. Run `itznexus auth status --json` to verify.

package/dist/skills/claude-code/itznexus-conversation.md

@@ -0,0 +1,146 @@
+---
+name: itznexus-conversation
+description: "Manage conversations via the ITzNexus CLI"
+---
+
+# itznexus conversation
+
+Manage conversations. All commands return JSON when called with `--json`.
+
+## Response Shape
+
+All commands output JSON to stdout:
+- **Success:** the created/updated/fetched object(s) directly
+- **Error:** process exits with code 1 and prints an error message to stderr
+
+## When to Use
+
+Use this skill when you need to create, read, update, or delete **conversation** records in ITzNexus. Always use the `--json` flag so output is machine-parseable.
+
+## Commands
+
+### list
+
+List conversations.
+
+```bash
+itznexus conversation list [--contact] [--lead] [--project] [--channel] [--status] [--search] --json
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--contact` | no | Filter by contact |
+| `--lead` | no | Filter by lead |
+| `--project` | no | Filter by project |
+| `--channel` | no | Filter by channel (upwork, whatsapp, email, slack) |
+| `--status` | no | Filter by status (active, archived) |
+| `--search` | no | Search by subject |
+
+### get
+
+Get conversation details with messages.
+
+```bash
+itznexus conversation get <id> --json
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `id` | yes | Conversation ID |
+
+### create
+
+Create a new conversation.
+
+```bash
+itznexus conversation create --contact <contactId> --channel <channel> [--subject] [--lead] [--project] --json
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--contact` | yes | Contact ID |
+| `--channel` | yes | Channel (upwork, whatsapp, email, slack) |
+| `--subject` | no | Subject |
+| `--lead` | no | Lead ID |
+| `--project` | no | Project ID |
+
+### update
+
+Update a conversation.
+
+```bash
+itznexus conversation update <id> [--subject] [--status] [--channel] [--lead] [--project] --json
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `id` | yes | Conversation ID |
+| `--subject` | no | Subject |
+| `--status` | no | Status (active, archived) |
+| `--channel` | no | Channel |
+| `--lead` | no | Lead ID |
+| `--project` | no | Project ID |
+
+### message
+
+Add a message to a conversation.
+
+```bash
+itznexus conversation message <conversationId> --body <text> [--direction] [--sender] --json
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `conversationId` | yes | Conversation ID |
+| `--body` | yes | Message body |
+| `--direction` | no | Direction (inbound, outbound) (default: `"outbound"`) |
+| `--sender` | no | Sender name (for inbound) |
+
+### delete
+
+Delete a conversation.
+
+```bash
+itznexus conversation delete <id> --json
+```
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `id` | yes | Conversation ID |
+
+## Example Flows
+
+**Start a conversation with a contact:**
+```bash
+itznexus conversation create --contact <contactId> --channel upwork --subject "Project proposal" --json
+```
+
+**Log an outbound message:**
+```bash
+itznexus conversation message <conversationId> --body "Hi, following up on the proposal" --json
+```
+
+**Log an inbound message:**
+```bash
+itznexus conversation message <conversationId> --body "Looks great, let's proceed" --direction inbound --sender "John" --json
+```
+
+**Link a conversation to a lead:**
+```bash
+itznexus conversation update <conversationId> --lead <leadId> --json
+```
+
+**List conversations by channel:**
+```bash
+itznexus conversation list --channel whatsapp --json
+```
+
+**Archive a conversation:**
+```bash
+itznexus conversation update <conversationId> --status archived --json
+```
+## Important
+
+- Always pass `--json` for machine-readable output.
+- IDs are UUIDs. Get them from `list` or `create` responses.
+- The CLI authenticates via API key stored in `~/.itznexus/config.json`. Run `itznexus auth status --json` to verify.