nolo-cli 0.1.41 → 0.1.43

package/cli/taskRunCommand.ts

@@ -1,265 +0,0 @@
-import { DEFAULT_NOLO_SERVER_URL } from "./defaultServer";
-import { existsSync, readFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-
-type EnvLike = Record<string, string | undefined>;
-type OutputLike = { write(chunk: string): unknown };
-
-type TaskRunCommandDeps = {
-  env?: EnvLike;
-  output?: OutputLike;
-  fetchImpl?: typeof fetch;
-};
-
-function parseEnvFile(path: string): EnvLike {
-  if (!path || !existsSync(path)) return {};
-  const parsed: EnvLike = {};
-  for (const rawLine of readFileSync(path, "utf8").split(/\r?\n/)) {
-    const line = rawLine.trim();
-    if (!line || line.startsWith("#")) continue;
-    const index = line.indexOf("=");
-    if (index <= 0) continue;
-    const key = line.slice(0, index).trim();
-    let value = line.slice(index + 1).trim();
-    if (
-      (value.startsWith('"') && value.endsWith('"')) ||
-      (value.startsWith("'") && value.endsWith("'"))
-    ) {
-      value = value.slice(1, -1);
-    }
-    if (key) parsed[key] = value;
-  }
-  return parsed;
-}
-
-function loadTaskRunEnv(env: EnvLike, options: { includeDefaultEnvFiles?: boolean } = {}) {
-  const envFileCandidates = [
-    env.NOLO_TASK_RUN_ENV_FILE,
-    env.NOLO_MACHINE_ENV_FILE,
-    ...(options.includeDefaultEnvFiles
-      ? ["/etc/nolo/machine-runner.env", join(homedir(), ".nolo", "machine-runner.env")]
-      : []),
-  ].filter((path): path is string => Boolean(path));
-  const fileEnv = Object.assign({}, ...envFileCandidates.map(parseEnvFile));
-  return { ...fileEnv, ...env };
-}
-
-function readOption(args: string[], flag: string) {
-  for (let i = 0; i < args.length; i++) {
-    const value = args[i];
-    if (value === flag) return args[i + 1] ?? "";
-    if (value.startsWith(`${flag}=`)) return value.slice(flag.length + 1);
-  }
-  return "";
-}
-
-function csv(raw: string) {
-  return raw.split(",").map((item) => item.trim()).filter(Boolean);
-}
-
-function optionalJson(args: string[], flag: string) {
-  const value = optional(args, flag);
-  if (!value) return undefined;
-  try {
-    return JSON.parse(value);
-  } catch (error) {
-    throw new Error(`${flag} must be valid JSON: ${error instanceof Error ? error.message : String(error)}`);
-  }
-}
-
-function resolveServerUrl(args: string[], env: EnvLike) {
-  return (
-    readOption(args, "--server-url") ||
-    readOption(args, "--server") ||
-    readOption(args, "--base-url") ||
-    env.NOLO_SERVER_URL ||
-    env.NOLO_SERVER ||
-    env.BASE_URL ||
-    DEFAULT_NOLO_SERVER_URL
-  ).replace(/\/+$/, "");
-}
-
-function resolveAuthToken(args: string[], env: EnvLike) {
-  return (
-    readOption(args, "--machine-key") ||
-    readOption(args, "--token") ||
-    env.NOLO_TASK_RUN_TOKEN ||
-    env.NOLO_MACHINE_API_KEY ||
-    env.AUTH_TOKEN ||
-    env.AUTH ||
-    ""
-  );
-}
-
-function required(args: string[], flag: string) {
-  const value = readOption(args, flag).trim();
-  if (!value) throw new Error(`${flag} is required`);
-  return value;
-}
-
-function optional(args: string[], flag: string) {
-  const value = readOption(args, flag).trim();
-  return value || undefined;
-}
-
-function buildBody(command: string, args: string[]) {
-  const dbKey = required(args, "--row-dbkey");
-  if (command === "read-context" || command === "readTaskContext") {
-    return { action: "readTaskContext", dbKey };
-  }
-  if (command === "claim-work-item" || command === "claimWorkItem") {
-    return {
-      action: "claimWorkItem",
-      dbKey,
-      workItemId: required(args, "--work-item-id"),
-      agentKey: required(args, "--agent-key"),
-      role: optional(args, "--role"),
-    };
-  }
-  if (command === "record-agent-run" || command === "recordAgentRun") {
-    const toolTraceSummary = optionalJson(args, "--tool-trace-summary");
-    return {
-      action: "recordAgentRun",
-      dbKey,
-      ...(optional(args, "--run-id") ? { runId: optional(args, "--run-id") } : {}),
-      agentKey: required(args, "--agent-key"),
-      ...(optional(args, "--role") ? { role: optional(args, "--role") } : {}),
-      runStatus: required(args, "--run-status"),
-      ...(optional(args, "--work-item-id") ? { workItemId: optional(args, "--work-item-id") } : {}),
-      ...(optional(args, "--dialog-id") ? { dialogId: optional(args, "--dialog-id") } : {}),
-      ...(optional(args, "--result-summary") ? { resultSummary: optional(args, "--result-summary") } : {}),
-      ...(optional(args, "--error-code") ? { errorCode: optional(args, "--error-code") } : {}),
-      ...(optional(args, "--tools-used") ? { toolsUsed: csv(optional(args, "--tools-used")!) } : {}),
-      ...(toolTraceSummary ? { toolTraceSummary } : {}),
-    };
-  }
-  if (command === "set-blocker" || command === "setBlocker") {
-    return {
-      action: "setBlocker",
-      dbKey,
-      workItemId: optional(args, "--work-item-id"),
-      blocker: {
-        layer: required(args, "--layer"),
-        code: required(args, "--code"),
-        message: required(args, "--message"),
-      },
-    };
-  }
-  if (command === "clear-blocker" || command === "clearBlocker") {
-    return {
-      action: "clearBlocker",
-      dbKey,
-      blockerId: required(args, "--blocker-id"),
-      workItemId: optional(args, "--work-item-id"),
-    };
-  }
-  if (command === "submit-outcome" || command === "submitOutcome") {
-    return {
-      action: "submitOutcome",
-      dbKey,
-      workItemId: required(args, "--work-item-id"),
-      summary: required(args, "--summary"),
-      ...(optional(args, "--dialog-id") ? { dialogId: optional(args, "--dialog-id") } : {}),
-      ...(optional(args, "--artifact-ids") ? { artifactIds: csv(optional(args, "--artifact-ids")!) } : {}),
-    };
-  }
-  if (command === "request-review" || command === "requestReview") {
-    return {
-      action: "requestReview",
-      dbKey,
-      workItemId: optional(args, "--work-item-id"),
-      reviewerAgentKey: required(args, "--reviewer-agent-key"),
-      ...(optional(args, "--dialog-id") ? { dialogId: optional(args, "--dialog-id") } : {}),
-      ...(optional(args, "--message") ? { message: optional(args, "--message") } : {}),
-      ...(optional(args, "--artifact-ids") ? { artifactIds: csv(optional(args, "--artifact-ids")!) } : {}),
-    };
-  }
-  if (command === "record-review" || command === "recordReview") {
-    return {
-      action: "recordReview",
-      dbKey,
-      ...(optional(args, "--work-item-id") ? { workItemId: optional(args, "--work-item-id") } : {}),
-      reviewStatus: required(args, "--review-status"),
-      ...(optional(args, "--reviewer-agent-key")
-        ? { reviewerAgentKey: optional(args, "--reviewer-agent-key") }
-        : {}),
-      ...(optional(args, "--dialog-id") ? { dialogId: optional(args, "--dialog-id") } : {}),
-      ...(optional(args, "--findings") ? { findings: optional(args, "--findings") } : {}),
-      ...(optional(args, "--artifact-ids") ? { artifactIds: csv(optional(args, "--artifact-ids")!) } : {}),
-    };
-  }
-  if (command === "close-work-item" || command === "complete-work-item" || command === "closeWorkItem" || command === "completeWorkItem") {
-    return {
-      action: "closeWorkItem",
-      dbKey,
-      workItemId: required(args, "--work-item-id"),
-      summary: required(args, "--summary"),
-      ...(optional(args, "--reason") ? { reason: optional(args, "--reason") } : {}),
-      ...(optional(args, "--dialog-id") ? { dialogId: optional(args, "--dialog-id") } : {}),
-      ...(optional(args, "--artifact-ids") ? { artifactIds: csv(optional(args, "--artifact-ids")!) } : {}),
-    };
-  }
-  throw new Error(`Unknown task-run command: ${command}`);
-}
-
-function usage() {
-  return [
-    "Usage:",
-    "  nolo task-run read-context --row-dbkey <row>",
-    "  nolo task-run claim-work-item --row-dbkey <row> --work-item-id <id> --agent-key <agent> [--role <role>]",
-    "  nolo task-run record-agent-run --row-dbkey <row> --agent-key <agent> --run-status <status> [--tools-used <csv>]",
-    "  nolo task-run set-blocker --row-dbkey <row> [--work-item-id <id>] --layer <layer> --code <code> --message <message>",
-    "  nolo task-run clear-blocker --row-dbkey <row> --blocker-id <id> [--work-item-id <id>]",
-    "  nolo task-run submit-outcome --row-dbkey <row> --work-item-id <id> --summary <summary> [--dialog-id <id>]",
-    "  nolo task-run request-review --row-dbkey <row> --reviewer-agent-key <agent> [--work-item-id <id>]",
-    "  nolo task-run record-review --row-dbkey <row> [--work-item-id <id>] --review-status <passed|needs_changes|blocked> [--findings <text>]",
-    "  nolo task-run close-work-item --row-dbkey <row> --work-item-id <id> --summary <summary>",
-    "",
-  ].join("\n");
-}
-
-export async function runTaskRunCommand(args: string[], deps: TaskRunCommandDeps = {}) {
-  const env = loadTaskRunEnv(deps.env ?? process.env, { includeDefaultEnvFiles: deps.env === undefined });
-  const output = deps.output ?? process.stdout;
-  const fetchImpl = deps.fetchImpl ?? fetch;
-  const command = args[0];
-  if (!command || command === "--help" || command === "-h") {
-    output.write(usage());
-    return 0;
-  }
-
-  let body: Record<string, unknown>;
-  try {
-    body = buildBody(command, args.slice(1));
-  } catch (error) {
-    output.write(`[nolo] task-run failed: ${error instanceof Error ? error.message : String(error)}\n`);
-    return 1;
-  }
-
-  const authToken = resolveAuthToken(args, env);
-  if (!authToken) {
-    output.write("[nolo] task-run failed: AUTH_TOKEN or NOLO_MACHINE_API_KEY is required.\n");
-    return 1;
-  }
-
-  const serverUrl = resolveServerUrl(args, env);
-  let response: Response;
-  try {
-    response = await fetchImpl(`${serverUrl}/api/task-run`, {
-      method: "POST",
-      headers: {
-        Authorization: `Bearer ${authToken}`,
-        "Content-Type": "application/json",
-      },
-      body: JSON.stringify(body),
-    });
-  } catch (error) {
-    output.write(`[nolo] task-run failed: ${error instanceof Error ? error.message : String(error)}\n`);
-    return 1;
-  }
-
-  const text = await response.text();
-  output.write(text.trim() ? `${text.trim()}\n` : "");
-  return response.ok ? 0 : 1;
-}

package/client/taskRunPrompt.ts

@@ -1,27 +0,0 @@
-export type TaskRunPromptContext = {
-  rowDbKey: string;
-  taskRunId?: string;
-  workItemId?: string;
-  artifactIds?: string[];
-};
-
-export function prependTaskRunPrompt(message: string, context?: TaskRunPromptContext): string {
-  if (!context?.rowDbKey) return message;
-  const artifactIds = context.artifactIds?.filter(Boolean) ?? [];
-  return [
-    "AI-native task-run context:",
-    "- This system is AI-native. The current task board is only the present observation and validation use case; different users, companies, and workflows may use different task owners later.",
-    "- Treat the task row meta as the durable execution context. Do not infer branch, runner, handoff, review, or blocker state from chat history alone.",
-    `- rowDbKey: ${context.rowDbKey}`,
-    ...(context.taskRunId ? [`- taskRunId: ${context.taskRunId}`] : []),
-    ...(context.workItemId ? [`- workItemId: ${context.workItemId}`] : []),
-    ...(artifactIds.length ? [`- artifactIds: ${artifactIds.join(",")}`] : []),
-    "- Handoff rule: start from the durable task context, then inspect existing refs such as workItems.dialogIds, workItems.outcome, review.dialogId, activityRefs, agentRuns.dialogId/resultSummary, and artifactRefs. Use dialog read/search for exact evidence.",
-    "- When you create, update, hand off, block, or review work, update the task context with `bun run task:run -- ...`.",
-    "- If this turn already includes a server TaskRun preflight snapshot, use that snapshot directly for read-only reporting or planning.",
-    "- Keep long reasoning and logs in the dialog; record only resumable references in task row meta.",
-    "",
-    "User task:",
-    message,
-  ].join("\n");
-}

package/integrations/xhs-reader/analyze/profileAnalyzer.ts

@@ -1,205 +0,0 @@
-/**
- * Deterministic profile analyzer for XHS collected data.
- * No LLM calls. Uses keyword-bucket heuristics for comment categorization.
- */
-
-import type {
-  XhsNoteSummary,
-  XhsNoteDetail,
-  XhsComment,
-  XhsProfileAnalysis,
-  XhsTopNote,
-  XhsCommentBucket,
-} from "../types";
-
-// --- Comment keyword buckets ---
-
-const BUCKET_DEFINITIONS: Array<{
-  label: string;
-  keywords: string[];
-}> = [
-  {
-    label: "询问求链接/教程",
-    keywords: ["链接", "求链接", "怎么买", "在哪买", "哪里买", "怎么弄", "教程", "怎么做的", "求分享", "私", "私信"],
-  },
-  {
-    label: "建议/攻略",
-    keywords: ["建议", "攻略", "推荐", "避雷", "踩雷", "注意", "tips", "经验", "分享", "干货"],
-  },
-  {
-    label: "赞美/鼓励",
-    keywords: ["好看", "太美", "太好看了", "好棒", "真棒", "厉害", "赞", "优秀", "绝了", "太绝", "爱了", "心动", "种草", "好爱"],
-  },
-  {
-    label: "提问/互动",
-    keywords: ["？", "?", "吗", "多少钱", "什么", "怎么", "为什么", "哪个", "什么时候"],
-  },
-  {
-    label: "搞笑/段子",
-    keywords: ["哈哈", "笑死", "哈哈哈", "笑死我", "绝绝子", "笑不活", "救命", "破防"],
-  },
-  {
-    label: "个人经历",
-    keywords: ["我也", "我之前", "我当时", "我是", "我用过", "我去过", "我觉得", "我也买", "我的"],
-  },
-];
-
-/**
- * Classify a comment into one or more buckets by keyword matching.
- * Returns bucket indices.
- */
-function classifyComment(content: string): number[] {
-  const lower = content.toLowerCase();
-  const matched: number[] = [];
-  for (let i = 0; i < BUCKET_DEFINITIONS.length; i++) {
-    const bucket = BUCKET_DEFINITIONS[i];
-    if (bucket.keywords.some((kw) => lower.includes(kw))) {
-      matched.push(i);
-    }
-  }
-  return matched;
-}
-
-/**
- * Find the note with the highest value for a given metric accessor.
- */
-function findTopNote(
-  details: XhsNoteDetail[],
-  accessor: (d: XhsNoteDetail) => number,
-): XhsTopNote | null {
-  if (details.length === 0) return null;
-  let best: XhsNoteDetail | null = null;
-  let bestValue = -1;
-  for (const d of details) {
-    const v = accessor(d);
-    if (v > bestValue) {
-      bestValue = v;
-      best = d;
-    }
-  }
-  if (!best) return null;
-  return {
-    noteId: best.noteId,
-    title: best.title,
-    count: bestValue,
-  };
-}
-
-/**
- * Analyze a collection of normalized notes and comments.
- *
- * @param notes - Note summaries (from profile listing).
- * @param details - Note details (if enriched).
- * @param commentsByNote - Map of noteId -> top-level comments.
- */
-export function analyzeProfile(
-  notes: XhsNoteSummary[],
-  details: XhsNoteDetail[],
-  commentsByNote: Record<string, XhsComment[]>,
-): XhsProfileAnalysis {
-  // Use details when available, fall back to note summaries
-  const hasDetails = details.length > 0;
-
-  const highestLikedNote = hasDetails
-    ? findTopNote(details, (d) => d.metrics.likedCount)
-    : findTopNoteFromSummaries(notes, (n) => n.likedCount ?? 0);
-
-  const highestCommentedNote = hasDetails
-    ? findTopNote(details, (d) => d.metrics.commentCount)
-    : findTopNoteFromCollectedComments(notes, commentsByNote);
-
-  const highestCollectedNote = hasDetails
-    ? findTopNote(details, (d) => d.metrics.collectedCount)
-    : null;
-
-  const highestSharedNote = hasDetails
-    ? findTopNote(details, (d) => d.metrics.shareCount)
-    : null;
-
-  // Aggregate all comments
-  const allComments: XhsComment[] = [];
-  for (const noteId of Object.keys(commentsByNote)) {
-    allComments.push(...commentsByNote[noteId]);
-  }
-
-  // Classify comments into buckets
-  const bucketCounts = BUCKET_DEFINITIONS.map(() => 0);
-  const bucketSamples = BUCKET_DEFINITIONS.map((): string[] => []);
-
-  for (const comment of allComments) {
-    const indices = classifyComment(comment.content);
-    for (const idx of indices) {
-      bucketCounts[idx]++;
-      if (bucketSamples[idx].length < 3) {
-        bucketSamples[idx].push(comment.commentId);
-      }
-    }
-  }
-
-  const commentBuckets: XhsCommentBucket[] = BUCKET_DEFINITIONS.map(
-    (def, i) => ({
-      label: def.label,
-      count: bucketCounts[i],
-      sampleCommentIds: bucketSamples[i],
-    }),
-  ).filter((b) => b.count > 0);
-
-  // Top liked comments
-  const topLikedComments = [...allComments]
-    .sort((a, b) => b.likeCount - a.likeCount)
-    .slice(0, 10);
-
-  return {
-    totalNotes: notes.length,
-    highestLikedNote,
-    highestCommentedNote,
-    highestCollectedNote,
-    highestSharedNote,
-    commentBuckets,
-    topLikedComments,
-  };
-}
-
-function findTopNoteFromSummaries(
-  notes: XhsNoteSummary[],
-  accessor: (n: XhsNoteSummary) => number,
-): XhsTopNote | null {
-  if (notes.length === 0) return null;
-  let best: XhsNoteSummary | null = null;
-  let bestValue = -1;
-  for (const n of notes) {
-    const v = accessor(n);
-    if (v > bestValue) {
-      bestValue = v;
-      best = n;
-    }
-  }
-  if (!best) return null;
-  return {
-    noteId: best.noteId,
-    title: best.title,
-    count: bestValue,
-  };
-}
-
-function findTopNoteFromCollectedComments(
-  notes: XhsNoteSummary[],
-  commentsByNote: Record<string, XhsComment[]>,
-): XhsTopNote | null {
-  if (notes.length === 0) return null;
-  let best: XhsNoteSummary | null = null;
-  let bestValue = -1;
-  for (const note of notes) {
-    const value = commentsByNote[note.noteId]?.length ?? 0;
-    if (value > bestValue) {
-      bestValue = value;
-      best = note;
-    }
-  }
-  if (!best || bestValue <= 0) return null;
-  return {
-    noteId: best.noteId,
-    title: best.title,
-    count: bestValue,
-  };
-}