@solo-kb/solo-learn 0.1.0

package/README.md

@@ -0,0 +1,21 @@
+# @solo-kb/solo-learn
+
+CLI for connecting agents to the Solo Learn production learning system.
+
+## Install
+
+```bash
+npm install -g @solo-kb/solo-learn
+```
+
+## Usage
+
+```bash
+solo-learn login
+solo-learn --json whoami
+solo-learn --json sessions list
+solo-learn --json sessions get <session_id>
+solo-learn --json steps submit <session_id> <step_id> --answer-file answer.md
+```
+
+Agent integrations should prefer `--json` for stable machine-readable output.

package/bin/solo-learn.mjs

@@ -0,0 +1,259 @@
+#!/usr/bin/env node
+import { chmodSync, existsSync, mkdirSync, readFileSync, rmSync, readdirSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+
+const DEFAULT_BASE_URL = 'https://kb.aipon.cn';
+
+class CliError extends Error {
+  constructor(code, message, status = 1) {
+    super(message);
+    this.code = code;
+    this.status = status;
+  }
+}
+
+function parseGlobal(argv) {
+  const options = { json: false, profile: 'default' };
+  const args = [];
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === '--json') options.json = true;
+    else if (arg === '--profile') {
+      options.profile = argv[++i];
+      if (!options.profile) throw new CliError('usage', '--profile 需要名称');
+    } else args.push(arg);
+  }
+  return { options, args };
+}
+
+function homeDir() {
+  return process.env.SOLO_LEARN_HOME || join(homedir(), '.solo-learn');
+}
+
+function profilePath(name) {
+  return join(homeDir(), 'profiles', `${name}.json`);
+}
+
+function readProfile(name) {
+  const path = profilePath(name);
+  if (!existsSync(path)) throw new CliError('unauthorized', '请先运行 solo-learn login');
+  try {
+    return JSON.parse(readFileSync(path, 'utf8'));
+  } catch (error) {
+    throw new CliError('profile_invalid', `profile 无法读取：${error.message}`);
+  }
+}
+
+function safeProfile(profile) {
+  return Object.fromEntries(Object.entries(profile).filter(([key]) => key !== 'accessToken'));
+}
+
+function writeProfile(name, profile) {
+  const path = profilePath(name);
+  mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+  writeFileSync(path, JSON.stringify(profile, null, 2));
+  chmodSync(path, 0o600);
+}
+
+function removeProfile(name) {
+  const path = profilePath(name);
+  if (existsSync(path)) rmSync(path);
+}
+
+function parseCommandOptions(args) {
+  const options = {};
+  const rest = [];
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+    if (arg === '--base-url') options.baseUrl = args[++i];
+    else if (arg === '--device-code') options.deviceCode = args[++i];
+    else if (arg === '--answer-file') options.answerFile = args[++i];
+    else rest.push(arg);
+  }
+  return { options, rest };
+}
+
+async function request(profile, method, path, body) {
+  const headers = { Authorization: `${profile.tokenType || 'Bearer'} ${profile.accessToken}` };
+  if (body !== undefined) headers['Content-Type'] = 'application/json';
+  const response = await fetch(`${profile.baseUrl}${path}`, {
+    method,
+    headers,
+    body: body === undefined ? undefined : JSON.stringify(body),
+  });
+  const text = await response.text();
+  const payload = text ? JSON.parse(text) : {};
+  if (!response.ok) {
+    throw new CliError(httpCode(response.status), payload.error || response.statusText, response.status === 401 ? 1 : 2);
+  }
+  return payload;
+}
+
+async function publicRequest(baseUrl, method, path, body) {
+  const response = await fetch(`${baseUrl}${path}`, {
+    method,
+    headers: body === undefined ? {} : { 'Content-Type': 'application/json' },
+    body: body === undefined ? undefined : JSON.stringify(body),
+  });
+  const text = await response.text();
+  const payload = text ? JSON.parse(text) : {};
+  if (!response.ok) throw new CliError(httpCode(response.status), payload.error || response.statusText, 2);
+  return payload;
+}
+
+function httpCode(status) {
+  if (status === 401) return 'unauthorized';
+  if (status === 403) return 'forbidden';
+  if (status === 404) return 'not_found';
+  if (status >= 500) return 'service_unavailable';
+  return 'request_failed';
+}
+
+function stepFromSession(session, stepId) {
+  const steps = session?.workshop?.steps || [];
+  const step = steps.find((item) => item.id === stepId);
+  if (!step) throw new CliError('not_found', `未找到步骤：${stepId}`, 2);
+  return step;
+}
+
+function allGaps(session) {
+  const gaps = session?.gaps || {};
+  if (Array.isArray(gaps)) return gaps;
+  return Object.entries(gaps).flatMap(([stepId, items]) => (items || []).map((gap) => Object.assign({ step_id: stepId }, gap)));
+}
+
+async function handle(args, profileName) {
+  const domain = args[0];
+  const action = args[1];
+  const tail = args.slice(2);
+  if (!domain) throw new CliError('usage', '缺少命令');
+
+  if (domain === 'login') {
+    const { options } = parseCommandOptions([action].concat(tail).filter(Boolean));
+    const baseUrl = options.baseUrl || DEFAULT_BASE_URL;
+    if (options.deviceCode) {
+      const result = await publicRequest(baseUrl, 'POST', '/api/cli/auth/device/poll', { device_code: options.deviceCode });
+      if (result.status !== 'approved') throw new CliError('authorization_pending', `授权状态：${result.status}`);
+      const profile = {
+        schemaVersion: 1,
+        name: profileName,
+        environment: 'production',
+        baseUrl,
+        tokenType: result.token_type || 'Bearer',
+        accessToken: result.access_token,
+        user: result.user,
+        createdAt: new Date().toISOString(),
+        expiresAt: result.expires_at ?? null,
+      };
+      writeProfile(profileName, profile);
+      return safeProfile(profile);
+    }
+    return publicRequest(baseUrl, 'POST', '/api/cli/auth/device/start');
+  }
+
+  if (domain === 'logout') {
+    try {
+      const profile = readProfile(profileName);
+      await request(profile, 'POST', '/api/cli/auth/revoke', {});
+    } catch (error) {
+      if (!(error instanceof CliError) || error.code !== 'unauthorized') throw error;
+    }
+    removeProfile(profileName);
+    return { logged_out: true };
+  }
+
+  if (domain === 'profile') {
+    if (action === 'list') {
+      const dir = join(homeDir(), 'profiles');
+      const profiles = existsSync(dir) ? readdirSync(dir).filter((name) => name.endsWith('.json')).map((name) => name.slice(0, -5)) : [];
+      return { profiles, current: profileName };
+    }
+    if (action === 'use') {
+      const next = tail[0];
+      if (!next) throw new CliError('usage', 'profile use 需要名称');
+      readProfile(next);
+      return { current: next };
+    }
+  }
+
+  const profile = readProfile(profileName);
+  if (domain === 'whoami') return request(profile, 'GET', '/api/cli/me');
+
+  if (domain === 'sessions') {
+    if (action === 'list') return request(profile, 'GET', '/api/cli/learning/sessions');
+    if (action === 'get') {
+      if (!tail[0]) throw new CliError('usage', 'sessions get 需要 session_id');
+      return request(profile, 'GET', `/api/cli/learning/sessions/${encodeURIComponent(tail[0])}`);
+    }
+    if (action === 'create') {
+      const goal = tail.join(' ').trim();
+      if (!goal) throw new CliError('usage', 'sessions create 需要学习目标');
+      return request(profile, 'POST', '/api/cli/learning/sessions', { goal });
+    }
+  }
+
+  if (domain === 'steps') {
+    const sessionId = tail[0];
+    if (!sessionId) throw new CliError('usage', `steps ${action || ''} 需要 session_id`);
+    if (action === 'list') {
+      const session = await request(profile, 'GET', `/api/cli/learning/sessions/${encodeURIComponent(sessionId)}`);
+      return session?.workshop?.steps || [];
+    }
+    const stepId = tail[1];
+    if (!stepId) throw new CliError('usage', `steps ${action || ''} 需要 step_id`);
+    if (action === 'get') {
+      const session = await request(profile, 'GET', `/api/cli/learning/sessions/${encodeURIComponent(sessionId)}`);
+      return stepFromSession(session, stepId);
+    }
+    if (action === 'submit') {
+      const { options } = parseCommandOptions(tail.slice(2));
+      if (!options.answerFile) throw new CliError('usage', 'steps submit 需要 --answer-file');
+      const answer = readFileSync(options.answerFile, 'utf8');
+      return request(profile, 'POST', `/api/cli/learning/sessions/${encodeURIComponent(sessionId)}/steps/${encodeURIComponent(stepId)}/submit`, { answer });
+    }
+  }
+
+  if (domain === 'gaps') {
+    const sessionId = tail[0];
+    if (!sessionId) throw new CliError('usage', `gaps ${action || ''} 需要 session_id`);
+    if (action === 'list') {
+      const session = await request(profile, 'GET', `/api/cli/learning/sessions/${encodeURIComponent(sessionId)}`);
+      return allGaps(session);
+    }
+    if (action === 'add') {
+      const stepId = tail[1];
+      const question = tail.slice(2).join(' ').trim();
+      if (!stepId || !question) throw new CliError('usage', 'gaps add 需要 step_id 和问题');
+      return request(profile, 'POST', `/api/cli/learning/sessions/${encodeURIComponent(sessionId)}/steps/${encodeURIComponent(stepId)}/gaps`, { question });
+    }
+    if (action === 'resolve') {
+      const gapId = tail[1];
+      if (!gapId) throw new CliError('usage', 'gaps resolve 需要 gap_id');
+      return request(profile, 'POST', `/api/cli/learning/sessions/${encodeURIComponent(sessionId)}/gaps/${encodeURIComponent(gapId)}/resolve`, {});
+    }
+  }
+
+  throw new CliError('usage', `未知命令：${[domain, action].filter(Boolean).join(' ')}`);
+}
+
+function printResult(options, data) {
+  if (options.json) console.log(JSON.stringify({ ok: true, data }));
+  else console.log(typeof data === 'string' ? data : JSON.stringify(data, null, 2));
+}
+
+function printError(options, error) {
+  const payload = { ok: false, error: { code: error.code || 'error', message: error.message || String(error) } };
+  if (options.json) console.log(JSON.stringify(payload));
+  else console.error(payload.error.message);
+}
+
+const { options, args } = parseGlobal(process.argv.slice(2));
+try {
+  const data = await handle(args, options.profile);
+  printResult(options, data);
+} catch (error) {
+  const cliError = error instanceof CliError ? error : new CliError('error', error.message || String(error), 1);
+  printError(options, cliError);
+  process.exit(cliError.status || 1);
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@solo-kb/solo-learn",
+  "version": "0.1.0",
+  "description": "CLI for connecting agents to the Solo Learn production learning system.",
+  "type": "module",
+  "bin": {
+    "solo-learn": "bin/solo-learn.mjs"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitee.com/lab-catty/solo-kb.git",
+    "directory": "cli/solo-learn"
+  },
+  "homepage": "https://gitee.com/lab-catty/solo-kb",
+  "bugs": {
+    "url": "https://gitee.com/lab-catty/solo-kb/issues"
+  },
+  "files": [
+    "bin/",
+    "README.md"
+  ]
+}