@onesclawkolor/onesclaw 0.1.0 → 0.1.1

package/dist/knowledge/helper-scripts.js

@@ -0,0 +1,325 @@
+import { access, chmod, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { getKnowledgeBinDir } from '../config/manager.js';
+const MANAGED_HEADER = '# Generated by onesclaw from /Users/kolor/Documents/docs Markdown. DO NOT EDIT.\n';
+export async function ensureKnowledgeHelperScripts() {
+    const dir = getKnowledgeBinDir();
+    const templates = getHelperScriptTemplates();
+    for (const template of templates) {
+        const path = join(dir, template.name);
+        await writeFile(path, template.content, 'utf-8');
+        await chmod(path, 0o755);
+    }
+    return templates.map((template) => ({
+        name: template.name,
+        path: join(dir, template.name),
+        description: template.description,
+        example_invocation: template.exampleInvocation,
+    }));
+}
+export async function listKnowledgeHelperScripts() {
+    const dir = getKnowledgeBinDir();
+    const templates = getHelperScriptTemplates();
+    const scripts = [];
+    for (const template of templates) {
+        const path = join(dir, template.name);
+        try {
+            await access(path);
+            scripts.push({
+                name: template.name,
+                path,
+                description: template.description,
+                example_invocation: template.exampleInvocation,
+            });
+        }
+        catch {
+            continue;
+        }
+    }
+    return scripts;
+}
+export function getHelperScriptTemplates() {
+    return [
+        {
+            name: 'check.sh',
+            description: '封装 envcheck.md 的环境检测下载、解压与执行流程',
+            exampleInvocation: '~/.onesclaw/kb/bin/check.sh --preset medium --arch amd64',
+            content: `${MANAGED_HEADER}#!/usr/bin/env bash
+set -euo pipefail
+
+PRESET="small"
+ARCH=""
+DATA_PATH="/data/ones"
+
+usage() {
+  cat <<'USAGE'
+Usage: check.sh [--preset small|medium|large|xlarge] [--arch amd64|arm64] [--data-path /data/ones]
+
+Presets are mapped from /Users/kolor/Documents/docs/environmental-requirements/K3S/envcheck.md:
+  small   -> 8 cores / 250GB / 24GB
+  medium  -> 16 cores / 1000GB / 48GB
+  large   -> 32 cores / 2000GB / 64GB
+  xlarge  -> 48 cores / 4000GB / 96GB
+USAGE
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --preset)
+      PRESET="$2"
+      shift 2
+      ;;
+    --arch)
+      ARCH="$2"
+      shift 2
+      ;;
+    --data-path)
+      DATA_PATH="$2"
+      shift 2
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "Unknown argument: $1" >&2
+      usage >&2
+      exit 1
+      ;;
+  esac
+done
+
+if [[ -z "$ARCH" ]]; then
+  case "$(uname -m)" in
+    x86_64|amd64) ARCH="amd64" ;;
+    aarch64|arm64) ARCH="arm64" ;;
+    *) echo "Unsupported architecture: $(uname -m)" >&2; exit 1 ;;
+  esac
+fi
+
+case "$PRESET" in
+  small)
+    CPU_CORES="8"
+    DATA_DISK_SIZE="250GB"
+    MEM_SIZE="24GB"
+    ;;
+  medium)
+    CPU_CORES="16"
+    DATA_DISK_SIZE="1000GB"
+    MEM_SIZE="48GB"
+    ;;
+  large)
+    CPU_CORES="32"
+    DATA_DISK_SIZE="2000GB"
+    MEM_SIZE="64GB"
+    ;;
+  xlarge)
+    CPU_CORES="48"
+    DATA_DISK_SIZE="4000GB"
+    MEM_SIZE="96GB"
+    ;;
+  *)
+    echo "Unsupported preset: $PRESET" >&2
+    usage >&2
+    exit 1
+    ;;
+esac
+
+ENVCHECK_BASE="https://ones-cn-package.oss-cn-shenzhen.aliyuncs.com/release/envcheck"
+ENVCHECK_VERSION="$(curl -Ls "$ENVCHECK_BASE/latest.txt")"
+if [[ -z "$ENVCHECK_VERSION" ]]; then
+  echo "Failed to resolve envcheck version" >&2
+  exit 1
+fi
+
+ARCHIVE_URL="$ENVCHECK_BASE/$ENVCHECK_VERSION/linux/$ARCH/envcheck.tar"
+echo "Downloading envcheck from: $ARCHIVE_URL"
+curl -O "$ARCHIVE_URL"
+tar -xvf envcheck.tar
+chmod +x envcheck
+./envcheck --cpu-cores "$CPU_CORES" --data-disk-size "$DATA_DISK_SIZE" --mem-size "$MEM_SIZE" --data-path "$DATA_PATH"
+`,
+        },
+        {
+            name: 'download-package.sh',
+            description: '封装 install-new.md / install-ha.md 的 quickstart 下载入口',
+            exampleInvocation: '~/.onesclaw/kb/bin/download-package.sh --version v6.18.0 --download',
+            content: `${MANAGED_HEADER}#!/usr/bin/env bash
+set -euo pipefail
+
+MODE="download"
+VERSION=""
+
+usage() {
+  cat <<'USAGE'
+Usage: download-package.sh [--list-versions] [--version <ones-version> --download]
+
+Document source:
+  - /Users/kolor/Documents/docs/install-upgrade/K3S/install-new.md
+  - /Users/kolor/Documents/docs/install-upgrade/K3S/install-ha.md
+USAGE
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --list-versions)
+      MODE="list"
+      shift
+      ;;
+    --version)
+      VERSION="$2"
+      shift 2
+      ;;
+    --download)
+      MODE="download"
+      shift
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "Unknown argument: $1" >&2
+      usage >&2
+      exit 1
+      ;;
+  esac
+done
+
+curl -O https://packages.ones.cn/release/latest/quickstart.sh
+
+if [[ "$MODE" == "list" ]]; then
+  bash quickstart.sh --list-versions
+  exit 0
+fi
+
+if [[ -z "$VERSION" ]]; then
+  echo "--version is required for download mode" >&2
+  usage >&2
+  exit 1
+fi
+
+bash quickstart.sh --version "$VERSION" --download
+`,
+        },
+        {
+            name: 'install-single.sh',
+            description: '封装 install-new.md 的单机离线安装入口',
+            exampleInvocation: '~/.onesclaw/kb/bin/install-single.sh --offline-file /data/install/ones_offline_pkg_xxx.tar.gz --data-dir /data/ones',
+            content: `${MANAGED_HEADER}#!/usr/bin/env bash
+set -euo pipefail
+
+OFFLINE_FILE=""
+DATA_DIR=""
+
+usage() {
+  cat <<'USAGE'
+Usage: install-single.sh --offline-file <ones_offline_pkg.tar.gz> [--data-dir /data/ones]
+
+Document source:
+  /Users/kolor/Documents/docs/install-upgrade/K3S/install-new.md
+USAGE
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --offline-file)
+      OFFLINE_FILE="$2"
+      shift 2
+      ;;
+    --data-dir)
+      DATA_DIR="$2"
+      shift 2
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "Unknown argument: $1" >&2
+      usage >&2
+      exit 1
+      ;;
+  esac
+done
+
+if [[ -z "$OFFLINE_FILE" ]]; then
+  echo "--offline-file is required" >&2
+  usage >&2
+  exit 1
+fi
+
+if [[ ! -f quickstart.sh ]]; then
+  echo "quickstart.sh not found in current directory" >&2
+  exit 1
+fi
+
+if [[ -n "$DATA_DIR" ]]; then
+  export ONES_DATA_DIR="$DATA_DIR"
+fi
+
+bash quickstart.sh --offline-file "$OFFLINE_FILE"
+`,
+        },
+        {
+            name: 'install-ha.sh',
+            description: '封装 install-ha.md 的 HA 离线安装入口',
+            exampleInvocation: '~/.onesclaw/kb/bin/install-ha.sh --offline-file /data/install/ones_offline_pkg_xxx.tar.gz --data-dir /data/ones',
+            content: `${MANAGED_HEADER}#!/usr/bin/env bash
+set -euo pipefail
+
+OFFLINE_FILE=""
+DATA_DIR=""
+
+usage() {
+  cat <<'USAGE'
+Usage: install-ha.sh --offline-file <ones_offline_pkg.tar.gz> [--data-dir /data/ones]
+
+Document source:
+  /Users/kolor/Documents/docs/install-upgrade/K3S/install-ha.md
+USAGE
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --offline-file)
+      OFFLINE_FILE="$2"
+      shift 2
+      ;;
+    --data-dir)
+      DATA_DIR="$2"
+      shift 2
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "Unknown argument: $1" >&2
+      usage >&2
+      exit 1
+      ;;
+  esac
+done
+
+if [[ -z "$OFFLINE_FILE" ]]; then
+  echo "--offline-file is required" >&2
+  usage >&2
+  exit 1
+fi
+
+if [[ ! -f quickstart.sh ]]; then
+  echo "quickstart.sh not found in current directory" >&2
+  exit 1
+fi
+
+if [[ -n "$DATA_DIR" ]]; then
+  export ONES_DATA_DIR="$DATA_DIR"
+fi
+
+DEPLOY_MODE=ha bash quickstart.sh --offline-file "$OFFLINE_FILE"
+`,
+        },
+    ];
+}
+//# sourceMappingURL=helper-scripts.js.map

package/dist/knowledge/helper-scripts.js.map

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

package/dist/knowledge/manager.d.ts

@@ -0,0 +1,28 @@
+import type { KnowledgeCommandBlock, KnowledgeConfig, KnowledgeHelperScript, KnowledgeSearchResult, KnowledgeStatus, SourceManifest } from './types.js';
+import { type CommandRunner } from './qmd.js';
+export declare class KnowledgeManager {
+    readonly config: KnowledgeConfig;
+    private readonly qmd;
+    private readonly commandBlockCache;
+    constructor(config?: Partial<KnowledgeConfig> | null, runner?: CommandRunner);
+    getPromptContext(): {
+        enabled: boolean;
+        sourceNames: string[];
+        priority: import("./types.js").KnowledgePriority[];
+    };
+    bootstrap(sourcePath: string, sourceName?: string): Promise<SourceManifest>;
+    syncAll(): Promise<SourceManifest[]>;
+    autoSyncIfNeeded(): Promise<void>;
+    status(): Promise<KnowledgeStatus>;
+    search(query: string, limit?: number): Promise<KnowledgeSearchResult[]>;
+    getDocument(pathRef: string, section?: string): Promise<string>;
+    extractCommands(pathRef: string, section?: string): Promise<KnowledgeCommandBlock[]>;
+    listHelperScripts(): Promise<KnowledgeHelperScript[]>;
+    private normalizeRelativePath;
+    private findSourceForRelativePath;
+    private readManagedDocument;
+    private syncSource;
+    private getCommandCacheKey;
+    private cleanManagedDirectory;
+    private readManifest;
+}