@mytegroupinc/myte-core 0.0.6 → 0.0.7

package/README.md

@@ -7,12 +7,18 @@ Most users should install the unscoped wrapper instead:
 - `npm install myte` then `npx myte sync-qaqc`
 - `npm install myte` then `npx myte query "..." --with-diff`
 - `npm install myte` then `npm exec myte -- query "..." --with-diff`
+- `npm install myte` then `npx myte update-team "Backend deploy completed; QAQC rerun queued."`
+- `npm install myte` then `npx myte update-client --subject "Weekly client update" --body-file ./updates/week-12.md`
 - `npm i -g myte` then `myte bootstrap`
 - `npm i -g myte` then `myte sync-qaqc`
 - `npm i -g myte` then `myte query "..." --with-diff`
+- `npm i -g myte` then `myte update-team "Backend deploy completed; QAQC rerun queued."`
+- `npm i -g myte` then `myte update-client --subject "Weekly client update" --body-file ./updates/week-12.md`
 - `npx myte@latest bootstrap`
 - `npx myte@latest sync-qaqc`
 - `npx myte@latest query "..." --with-diff`
+- `npx myte@latest update-team "Backend deploy completed; QAQC rerun queued."`
+- `npx myte@latest update-client --subject "Weekly client update" --body-file ./updates/week-12.md`
 - `npm install myte` then `npx myte create-prd ./drafts/auth-prd.md`
 - `cat ./drafts/auth-prd.md | npx myte create-prd --stdin`
 
@@ -36,6 +42,10 @@ Notes:
 - `sync-qaqc` only exports active `Todo` / `In Progress` missions plus a public QAQC summary and sanitized latest batch metadata.
 - `sync-qaqc` removes previously QAQC-managed mission files from `MyteCommandCenter/data/missions` once they leave the active set.
 - `create-prd` is a deterministic PRD upload path, not an LLM generation command.
+- `update-team` creates a project comment through `/api/project-assistant/project-comment`.
+- `update-client` creates a client update draft through `/api/project-assistant/client-update-drafts`.
+- `update-client` requires `--subject` plus body markdown from `--body-markdown`, `--body-file`, positional input, or `--stdin`.
+- `update-client` accepts optional `--target-contact-id` repeats or `--target-contact-ids <id1,id2>`.
 - `--with-diff` only searches repo folders whose names match the project repo names configured in Myte.
 - `--with-diff` includes per-repo diagnostics in `print-context` payload:
   - missing repo directories
@@ -58,5 +68,7 @@ Examples:
 - `npx myte sync-qaqc --dry-run --json`
 - `npx myte create-prd ./drafts/auth-prd.md --description "Short card summary"`
 - `npx myte create-prd ./drafts/auth-prd.md --print-context`
+- `npx myte update-team "Backend deploy completed; QAQC rerun queued."`
+- `npx myte update-client --subject "Weekly client update" --body-file ./updates/week-12.md`
 
 This package is published under the org scope for governance; the public `myte` wrapper delegates here.

package/cli.js

@@ -49,7 +49,23 @@ function loadEnv() {
 }
 
 function splitCommand(argv) {
-  const known = new Set(["query", "ask", "chat", "config", "bootstrap", "sync-qaqc", "qaqc-sync", "create-prd", "add-prd", "prd", "help", "--help", "-h"]);
+  const known = new Set([
+    "query",
+    "ask",
+    "chat",
+    "config",
+    "bootstrap",
+    "sync-qaqc",
+    "qaqc-sync",
+    "create-prd",
+    "add-prd",
+    "prd",
+    "update-team",
+    "update-client",
+    "help",
+    "--help",
+    "-h",
+  ]);
   const first = argv[0];
   if (first && known.has(first)) {
     const cmd = first === "--help" || first === "-h" ? "help" : first;
@@ -63,7 +79,25 @@ function parseArgs(argv) {
     // eslint-disable-next-line global-require
     return require("minimist")(argv, {
       boolean: ["with-diff", "diff", "print-context", "dry-run", "fetch", "json", "stdin"],
-      string: ["query", "q", "context", "ctx", "base-url", "timeout-ms", "diff-limit", "title", "description", "feedback-text", "output-dir"],
+      string: [
+        "query",
+        "q",
+        "context",
+        "ctx",
+        "base-url",
+        "timeout-ms",
+        "diff-limit",
+        "title",
+        "description",
+        "feedback-text",
+        "output-dir",
+        "content",
+        "subject",
+        "body-markdown",
+        "body-file",
+        "target-contact-id",
+        "target-contact-ids",
+      ],
       alias: {
         q: "query",
         d: "with-diff",
@@ -118,10 +152,13 @@ function printHelp() {
     "  myte config [--json]",
     "  myte bootstrap [--output-dir ./MyteCommandCenter] [--json]",
     "  myte sync-qaqc [--output-dir ./MyteCommandCenter] [--json]",
+    "  myte update-team \"<content>\" [--json]",
+    "  myte update-client --subject \"<text>\" [--body-markdown \"...\"] [--body-file ./update.md] [--target-contact-ids <id1,id2>] [--json]",
     "  myte chat",
     "  myte create-prd <file.md> [--json] [--title \"...\"] [--description \"...\"]",
     "  myte add-prd <file.md> [--json]",
     "  cat file.md | myte create-prd --stdin [--title \"...\"] [--description \"...\"]",
+    "  cat update.md | myte update-client --stdin --subject \"Weekly client update\"",
     "",
     "Run forms:",
     "  npm install myte   then npx myte query \"...\" --with-diff",
@@ -149,15 +186,30 @@ function printHelp() {
     "  - Description source: myte-kanban.description or --description",
     "  - PRD DOCX content: the markdown body is stored verbatim",
     "",
+    "update-team contract:",
+    "  - Creates a project team comment through /api/project-assistant/project-comment",
+    "  - Required: content (inline, --content, or --stdin)",
+    "",
+    "update-client contract:",
+    "  - Creates a client update draft through /api/project-assistant/client-update-drafts",
+    "  - Required: --subject and body markdown (via --body-markdown, --body-file, positional file/text, or --stdin)",
+    "  - Optional: --target-contact-id <id> (repeatable) or --target-contact-ids <id1,id2>",
+    "",
     "Options:",
     "  --with-diff           Include deterministic git diffs (project-scoped)",
     "  --diff-limit <chars>  Truncate diff context to N chars (default: 200000)",
     "  --timeout-ms <ms>     Request timeout (default: 300000)",
     "  --base-url <url>      API base (default: https://api.myte.dev)",
     "  --output-dir <path>   Bootstrap output directory (default: <wrapper-root>/MyteCommandCenter)",
-    "  --stdin               Read PRD content from stdin instead of a file path",
+    "  --stdin               Read supported command content from stdin instead of inline text or a file path",
     "  --title <text>        Override PRD title for raw markdown uploads",
     "  --description <text>  Set feedback description/card summary for raw markdown uploads",
+    "  --content <text>      Team update content for update-team",
+    "  --subject <text>      Client update subject for update-client",
+    "  --body-markdown <md>  Client update markdown body for update-client",
+    "  --body-file <path>    Read client update markdown body from a file",
+    "  --target-contact-id   Add one client contact ObjectId (repeatable)",
+    "  --target-contact-ids  Comma-separated client contact ObjectIds",
     "  --print-context       Print JSON payload and exit (no query call)",
     "  --no-fetch            Don't git fetch origin main/master before diff",
     "",
@@ -166,6 +218,9 @@ function printHelp() {
     "  myte bootstrap",
     "  myte bootstrap --output-dir ./MyteCommandCenter",
     "  myte sync-qaqc",
+    "  myte update-team \"Backend deploy completed; QAQC rerun queued.\"",
+    "  myte update-client --subject \"Weekly client update\" --body-file ./updates/week-12.md",
+    "  myte update-client --subject \"Weekly client update\" --body-markdown \"## Progress\\n- Login complete\" --target-contact-ids 507f1f77bcf86cd799439011,507f1f77bcf86cd799439012",
     "  myte create-prd ./drafts/auth-prd.md --description \"Short card summary\"",
     "  cat ./drafts/auth-prd.md | myte create-prd --stdin",
     "  myte config",
@@ -202,6 +257,139 @@ async function readStdinText() {
   });
 }
 
+function firstNonEmptyString(...values) {
+  for (const value of values) {
+    if (value === undefined || value === null) continue;
+    if (Array.isArray(value)) {
+      const nested = firstNonEmptyString(...value);
+      if (nested) return nested;
+      continue;
+    }
+    const text = String(value).trim();
+    if (text) return text;
+  }
+  return "";
+}
+
+function toStringArray(value) {
+  if (value === undefined || value === null) return [];
+  return Array.isArray(value) ? value.flatMap((item) => toStringArray(item)) : [String(value)];
+}
+
+function parseCsvValues(...values) {
+  return values
+    .flatMap((value) => toStringArray(value))
+    .flatMap((value) => value.split(","))
+    .map((value) => value.trim())
+    .filter(Boolean);
+}
+
+function dedupeStrings(values) {
+  const seen = new Set();
+  const unique = [];
+  for (const value of values) {
+    const normalized = String(value || "").trim();
+    if (!normalized || seen.has(normalized)) continue;
+    seen.add(normalized);
+    unique.push(normalized);
+  }
+  return unique;
+}
+
+function resolveTimeoutMs(args) {
+  const timeoutRaw = args["timeout-ms"] || args.timeoutMs || args.timeout_ms;
+  const timeoutParsed = timeoutRaw !== undefined ? Number(timeoutRaw) : 300_000;
+  return Number.isFinite(timeoutParsed) ? timeoutParsed : 300_000;
+}
+
+function resolveApiBase(args) {
+  const baseRaw =
+    args["base-url"] || args.baseUrl || args.base_url || process.env.MYTE_API_BASE || DEFAULT_API_BASE;
+  return normalizeApiBase(baseRaw);
+}
+
+function getProjectApiKey() {
+  return (process.env.MYTE_API_KEY || process.env.MYTE_PROJECT_API_KEY || "").trim();
+}
+
+function resolveInputFile(candidatePath, label) {
+  const resolved = String(candidatePath || "").trim();
+  if (!resolved) return null;
+  const absPath = path.resolve(process.cwd(), resolved);
+  if (!fs.existsSync(absPath) || !fs.statSync(absPath).isFile()) {
+    console.error(`${label} file not found: ${absPath}`);
+    process.exit(1);
+  }
+  return absPath;
+}
+
+async function resolveTeamUpdateContent(args) {
+  const inlineContent = firstNonEmptyString(args.content, Array.isArray(args._) ? args._.join(" ") : args._);
+  const useStdin = Boolean(args.stdin || (!process.stdin.isTTY && !inlineContent));
+  if (useStdin) {
+    const stdinContent = String((await readStdinText()) || "").trim();
+    if (!stdinContent) {
+      console.error("Team update content is empty.");
+      process.exit(1);
+    }
+    return stdinContent;
+  }
+
+  const content = String(inlineContent || "").trim();
+  if (!content) {
+    console.error("Missing team update content.");
+    printHelp();
+    process.exit(1);
+  }
+  return content;
+}
+
+async function resolveClientUpdateBody(args) {
+  const inlineBody = firstNonEmptyString(
+    args["body-markdown"],
+    args.bodyMarkdown,
+    args.body_markdown
+  );
+  if (inlineBody) return inlineBody;
+
+  const explicitFile = firstNonEmptyString(args["body-file"], args.bodyFile, args.body_file);
+  const positionalInput = firstNonEmptyString(Array.isArray(args._) ? args._.join(" ") : args._);
+  const useStdin = Boolean(args.stdin || (!process.stdin.isTTY && !explicitFile && !positionalInput));
+  if (useStdin) {
+    const stdinBody = String((await readStdinText()) || "").trim();
+    if (!stdinBody) {
+      console.error("Client update body_markdown is empty.");
+      process.exit(1);
+    }
+    return stdinBody;
+  }
+
+  const fileCandidate = explicitFile || (positionalInput && fs.existsSync(path.resolve(process.cwd(), positionalInput)) ? positionalInput : "");
+  if (fileCandidate) {
+    const absPath = resolveInputFile(fileCandidate, "Client update body");
+    return String(fs.readFileSync(absPath, "utf8") || "").trim();
+  }
+
+  if (positionalInput) return positionalInput;
+
+  console.error("Missing client update body_markdown.");
+  printHelp();
+  process.exit(1);
+}
+
+function resolveTargetContactIds(args) {
+  return dedupeStrings(
+    parseCsvValues(
+      args["target-contact-id"],
+      args.targetContactId,
+      args.target_contact_id,
+      args["target-contact-ids"],
+      args.targetContactIds,
+      args.target_contact_ids
+    )
+  );
+}
+
 async function getFetch() {
   if (typeof fetch !== "undefined") return fetch;
   const mod = await import("node-fetch");
@@ -789,6 +977,138 @@ async function callAssistantQuery({ apiBase, key, payload, timeoutMs, endpoint =
   return body.data || {};
 }
 
+function formatTargetContacts(contacts) {
+  const items = Array.isArray(contacts) ? contacts : [];
+  const formatted = items
+    .map((contact) => {
+      const name = String(contact?.name || "").trim();
+      const email = String(contact?.email || "").trim();
+      if (name && email) return `${name} <${email}>`;
+      return name || email || String(contact?.contact_id || "").trim();
+    })
+    .filter(Boolean);
+  return formatted.join(", ");
+}
+
+async function runUpdateTeam(args) {
+  const key = getProjectApiKey();
+  if (!key) {
+    console.error("Missing MYTE_API_KEY (project key) in environment/.env");
+    process.exit(1);
+  }
+
+  const payload = {
+    content: await resolveTeamUpdateContent(args),
+  };
+
+  if (args["print-context"] || args.printContext || args["dry-run"] || args.dryRun) {
+    console.log(JSON.stringify(payload, null, 2));
+    return;
+  }
+
+  const timeoutMs = resolveTimeoutMs(args);
+  const apiBase = resolveApiBase(args);
+
+  let data;
+  try {
+    data = await callAssistantQuery({
+      apiBase,
+      key,
+      payload,
+      timeoutMs,
+      endpoint: "/project-assistant/project-comment",
+    });
+  } catch (err) {
+    if (err?.name === "AbortError") {
+      console.error(`Request timed out after ${timeoutMs}ms`);
+    } else {
+      console.error("Team update failed:", err?.message || err);
+    }
+    process.exit(1);
+  }
+
+  if (args.json) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+
+  if (data.comment_id) console.log(`Comment ID: ${data.comment_id}`);
+  if (data.project_id) console.log(`Project ID: ${data.project_id}`);
+  if (data.user?.name) console.log(`Author: ${data.user.name}`);
+  if (data.created_at) console.log(`Created At: ${data.created_at}`);
+  if (data.content) {
+    console.log("Content:");
+    console.log(data.content);
+  }
+}
+
+async function runUpdateClient(args) {
+  const key = getProjectApiKey();
+  if (!key) {
+    console.error("Missing MYTE_API_KEY (project key) in environment/.env");
+    process.exit(1);
+  }
+
+  const subject = firstNonEmptyString(args.subject);
+  if (!subject) {
+    console.error("Missing --subject for client update.");
+    printHelp();
+    process.exit(1);
+  }
+
+  const payload = {
+    subject,
+    body_markdown: await resolveClientUpdateBody(args),
+    target_contact_ids: resolveTargetContactIds(args),
+  };
+
+  if (args["print-context"] || args.printContext || args["dry-run"] || args.dryRun) {
+    console.log(JSON.stringify(payload, null, 2));
+    return;
+  }
+
+  const timeoutMs = resolveTimeoutMs(args);
+  const apiBase = resolveApiBase(args);
+
+  let data;
+  try {
+    data = await callAssistantQuery({
+      apiBase,
+      key,
+      payload,
+      timeoutMs,
+      endpoint: "/project-assistant/client-update-drafts",
+    });
+  } catch (err) {
+    if (err?.name === "AbortError") {
+      console.error(`Request timed out after ${timeoutMs}ms`);
+    } else {
+      console.error("Client update draft failed:", err?.message || err);
+    }
+    process.exit(1);
+  }
+
+  if (args.json) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+
+  if (data.draft_id) console.log(`Draft ID: ${data.draft_id}`);
+  if (data.project_title) console.log(`Project: ${data.project_title}`);
+  if (data.project_id) console.log(`Project ID: ${data.project_id}`);
+  if (data.status) console.log(`Status: ${data.status}`);
+  if (data.subject) console.log(`Subject: ${data.subject}`);
+  if (data.created_by_name) console.log(`Author: ${data.created_by_name}`);
+  const targets = formatTargetContacts(data.target_contacts);
+  if (targets) console.log(`Targets: ${targets}`);
+  if (data.created_at) console.log(`Created At: ${data.created_at}`);
+  if (data.updated_at) console.log(`Updated At: ${data.updated_at}`);
+  if (data.snippet) {
+    console.log("Snippet:");
+    console.log(data.snippet);
+  }
+}
+
 function ensureDir(dirPath) {
   fs.mkdirSync(dirPath, { recursive: true });
 }
@@ -1500,6 +1820,16 @@ async function main() {
     return;
   }
 
+  if (command === "update-team") {
+    await runUpdateTeam(args);
+    return;
+  }
+
+  if (command === "update-client") {
+    await runUpdateClient(args);
+    return;
+  }
+
   // query/ask default
   await runQuery(args);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mytegroupinc/myte-core",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "description": "Myte CLI core implementation (Project Assistant + deterministic diffs).",
   "type": "commonjs",
   "main": "cli.js",