toolnet-memory 0.2.0

package/.env.example

@@ -0,0 +1,28 @@
+# Storage provider
+MEMORY_STORAGE_PROVIDER=huggingface
+
+# Hugging Face Storage Bucket
+HF_NAMESPACE=
+HF_BUCKET=toolnet-memory
+
+# Generate these from:
+# Hugging Face Settings -> Access Tokens
+# -> token dropdown -> Generate S3 credentials
+HF_S3_ACCESS_KEY_ID=
+HF_S3_SECRET_ACCESS_KEY=
+
+# Local fallback/cache
+MEMORY_LOCAL_STORAGE_PATH=
+MEMORY_LOCAL_CACHE_MB=200
+
+# Automation
+MEMORY_AUTO_CAPTURE=true
+MEMORY_AUTO_RETRIEVE=true
+MEMORY_AUTO_SUMMARIZE=true
+MEMORY_AUTO_SYNC=true
+
+# Retrieval
+MEMORY_MAX_CANDIDATES=50
+MEMORY_RERANK_TOP=10
+MEMORY_FINAL_CONTEXT=5
+MEMORY_TOKEN_BUDGET=2000

package/README.md

@@ -0,0 +1,147 @@
+# ToolNet Memory
+
+Persistent memory + code intelligence cho AI coding agents.
+
+## Tính năng
+
+- Mỗi thư mục = 1 project độc lập
+- Persistent memory
+- Code Graph + Type Resolution
+- Semantic Code Search
+- Architecture & Dependency Analysis
+- Dead Code / Impact Guard
+- Snapshots
+- MCP tools
+- Multi-project 3D Graph
+
+## Cài đặt
+
+```bash
+git clone https://github.com/LBT-AI/toolnet-memory
+cd toolnet-memory
+npm install
+npm run build
+npm link
+```
+
+Kiểm tra:
+
+```bash
+toolnet-memory help
+toolnet-memory doctor
+```
+
+## Cấu hình
+
+Tạo config dùng chung:
+
+```bash
+mkdir -p ~/.config/toolnet-memory
+cp .env.example ~/.config/toolnet-memory/.env
+chmod 600 ~/.config/toolnet-memory/.env
+```
+
+Điền Hugging Face Storage credentials vào:
+
+```text
+~/.config/toolnet-memory/.env
+```
+
+## Sử dụng
+
+Đi vào project cần index:
+
+```bash
+cd ~/ToolNetSecrets
+toolnet-memory index
+```
+
+ToolNet tự tạo:
+
+```text
+ToolNetSecrets/.toolnet/project.json
+```
+
+và lưu riêng trên remote:
+
+```text
+projects/ToolNetSecrets/
+├── memory/
+├── code/
+└── snapshots/
+```
+
+Project khác cũng hoàn toàn độc lập:
+
+```bash
+cd ~/Mercedes
+toolnet-memory index
+```
+
+## Full Index Pipeline
+
+```text
+Source Index
+→ Type Resolution
+→ Rich Graph
+→ Semantic Index
+→ Architecture
+→ Analysis
+→ 3D Visualization
+```
+
+## 3D Graph
+
+Chạy dashboard:
+
+```bash
+cd ~/toolnet-memory
+TOOLNET_GRAPH_HOST=0.0.0.0 TOOLNET_GRAPH_PORT=9749 npm run graph:ui
+```
+
+Mở:
+
+```text
+http://SERVER_IP:9749
+```
+
+Một dashboard có thể chuyển giữa nhiều project, nhưng dữ liệu của từng project vẫn tách biệt.
+
+## Lệnh chính
+
+```bash
+toolnet-memory doctor
+toolnet-memory index
+toolnet-memory index:graph
+toolnet-memory incremental
+toolnet-memory semantic "query"
+toolnet-memory impact [file]
+toolnet-memory mcp
+toolnet-memory snapshot:list
+toolnet-memory snapshot:create "reason"
+toolnet-memory snapshot:restore <id>
+toolnet-memory recover
+```
+
+## Development
+
+```bash
+npm run build
+npm test
+```
+
+> 1 folder = 1 project = 1 isolated memory universe.
+
+## Cài nhanh
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/LBT-AI/toolnet-memory/main/scripts/install.sh | bash
+```
+
+Sau đó:
+
+```bash
+source ~/.profile
+cd ~/your-project
+toolnet-memory index
+```

package/bin/toolnet-memory

@@ -0,0 +1,415 @@
+#!/usr/bin/env bash
+set -e
+
+SOURCE="${BASH_SOURCE[0]}"
+
+while [ -h "$SOURCE" ]; do
+  DIR="$(cd -P "$(dirname "$SOURCE")" >/dev/null 2>&1 && pwd)"
+  SOURCE="$(readlink "$SOURCE")"
+  [[ "$SOURCE" != /* ]] && SOURCE="$DIR/$SOURCE"
+done
+
+ROOT="$(cd -P "$(dirname "$SOURCE")/.." >/dev/null 2>&1 && pwd)"
+NODE="${NODE_BINARY:-node}"
+TSX="$ROOT/node_modules/.bin/tsx"
+
+COMMAND="${1:-help}"
+
+run() {
+  DIST="$1"
+  SRC="$2"
+  shift 2
+
+  if [ -f "$ROOT/$DIST" ]; then
+    exec "$NODE" "$ROOT/$DIST" "$@"
+  fi
+
+  # Development checkout fallback only.
+  if [ -x "$TSX" ] && [ -f "$ROOT/$SRC" ]; then
+    exec "$TSX" "$ROOT/$SRC" "$@"
+  fi
+
+  echo "ToolNet production build missing."
+  echo "Run: npm run build:prod"
+  exit 1
+}
+
+case "$COMMAND" in
+  doctor)
+    run dist/src/production/doctor.js src/production/doctor.ts
+    ;;
+
+  run)
+    run dist/index.js src/index.ts
+    ;;
+
+  mcp)
+    run dist/src/mcp/bootstrap.js src/mcp/bootstrap.ts
+    ;;
+
+  index)
+    run dist/src/production/full-index.js src/production/full-index.ts
+    ;;
+
+  index:graph)
+    run dist/src/code-intelligence/test-index.js src/code-intelligence/test-index.ts
+    ;;
+
+  incremental)
+    run dist/src/code-intelligence/test-incremental.js src/code-intelligence/test-incremental.ts
+    ;;
+
+  semantic)
+    shift
+    run dist/src/code-intelligence/test-semantic.js src/code-intelligence/test-semantic.ts "$@"
+    ;;
+
+  impact)
+    shift
+    run dist/src/code-intelligence/test-impact.js src/code-intelligence/test-impact.ts "$@"
+    ;;
+
+  snapshot:list)
+    run dist/src/production/snapshot-cli.js src/production/snapshot-cli.ts list
+    ;;
+
+  snapshot:create)
+    shift
+    run dist/src/production/snapshot-cli.js src/production/snapshot-cli.ts create "$@"
+    ;;
+
+  snapshot:restore)
+    shift
+    run dist/src/production/snapshot-cli.js src/production/snapshot-cli.ts restore "$@"
+    ;;
+
+  recover)
+    run dist/src/production/snapshot-cli.js src/production/snapshot-cli.ts recover-latest
+    ;;
+
+  session:opencode-sync)
+    shift
+
+    if [ -f "$ROOT/dist/src/session/opencode/cli.js" ]; then
+      exec node "$ROOT/dist/src/session/opencode/cli.js" sync "$@"
+    fi
+
+    if [ -n "${TSX:-}" ] && [ -x "${TSX:-}" ]; then
+      exec "$TSX" "$ROOT/src/session/opencode/cli.ts" sync "$@"
+    fi
+
+    echo "OpenCode session adapter not found."
+    exit 1
+    ;;
+
+  session:opencode-recover)
+    shift
+
+    if [ -f "$ROOT/dist/src/session/opencode/cli.js" ]; then
+      exec node "$ROOT/dist/src/session/opencode/cli.js" recover "$@"
+    fi
+
+    if [ -n "${TSX:-}" ] && [ -x "${TSX:-}" ]; then
+      exec "$TSX" "$ROOT/src/session/opencode/cli.ts" recover "$@"
+    fi
+
+    echo "OpenCode session adapter not found."
+    exit 1
+    ;;
+
+  integrate:opencode)
+    shift
+
+    if [ -f "$ROOT/dist/src/session/opencode/cli.js" ]; then
+      exec node "$ROOT/dist/src/session/opencode/cli.js" install-plugin "$@"
+    fi
+
+    if [ -n "${TSX:-}" ] && [ -x "${TSX:-}" ]; then
+      exec "$TSX" "$ROOT/src/session/opencode/cli.ts" install-plugin "$@"
+    fi
+
+    echo "OpenCode plugin installer not found."
+    exit 1
+    ;;
+
+  session:agy-hook)
+    shift
+
+    if [ -f "$ROOT/dist/src/session/agy/hook.js" ]; then
+      exec node "$ROOT/dist/src/session/agy/hook.js" "$@"
+    fi
+
+    if [ -x "${TSX:-}" ]; then
+      exec "$TSX" "$ROOT/src/session/agy/hook.ts" "$@"
+    fi
+
+    exit 0
+    ;;
+
+  session:agy-sync)
+    shift
+
+    if [ -f "$ROOT/dist/src/session/agy/cli.js" ]; then
+      exec node "$ROOT/dist/src/session/agy/cli.js" sync "$@"
+    fi
+
+    exec "$TSX" "$ROOT/src/session/agy/cli.ts" sync "$@"
+    ;;
+
+  session:agy-recover)
+    shift
+
+    if [ -f "$ROOT/dist/src/session/agy/cli.js" ]; then
+      exec node "$ROOT/dist/src/session/agy/cli.js" recover "$@"
+    fi
+
+    exec "$TSX" "$ROOT/src/session/agy/cli.ts" recover "$@"
+    ;;
+
+  integrate:agy)
+    shift
+
+    if [ -f "$ROOT/dist/src/session/agy/cli.js" ]; then
+      exec node "$ROOT/dist/src/session/agy/cli.js" install-hooks "$@"
+    fi
+
+    exec "$TSX" "$ROOT/src/session/agy/cli.ts" install-hooks "$@"
+    ;;
+
+  session:codex-notify)
+    shift
+
+    if [ -f "$ROOT/dist/src/session/codex/cli.js" ]; then
+      exec node "$ROOT/dist/src/session/codex/cli.js" notify "$@"
+    fi
+
+    if [ -x "${TSX:-}" ]; then
+      exec "$TSX" "$ROOT/src/session/codex/cli.ts" notify "$@"
+    fi
+
+    exit 0
+    ;;
+
+  session:codex-sync)
+    shift
+
+    if [ -f "$ROOT/dist/src/session/codex/cli.js" ]; then
+      exec node "$ROOT/dist/src/session/codex/cli.js" sync "$@"
+    fi
+
+    exec "$TSX" "$ROOT/src/session/codex/cli.ts" sync "$@"
+    ;;
+
+  session:codex-recover)
+    shift
+
+    if [ -f "$ROOT/dist/src/session/codex/cli.js" ]; then
+      exec node "$ROOT/dist/src/session/codex/cli.js" recover "$@"
+    fi
+
+    exec "$TSX" "$ROOT/src/session/codex/cli.ts" recover "$@"
+    ;;
+
+  integrate:codex)
+    shift
+
+    if [ -f "$ROOT/dist/src/session/codex/cli.js" ]; then
+      exec node "$ROOT/dist/src/session/codex/cli.js" install-notify "$@"
+    fi
+
+    exec "$TSX" "$ROOT/src/session/codex/cli.ts" install-notify "$@"
+    ;;
+
+  memory:reconcile)
+    shift
+
+    if [ -f "$ROOT/dist/src/session/learner/cli.js" ]; then
+      exec node "$ROOT/dist/src/session/learner/cli.js" reconcile "$@"
+    fi
+
+    if [ -x "${TSX:-}" ]; then
+      exec "$TSX" "$ROOT/src/session/learner/cli.ts" reconcile "$@"
+    fi
+
+    echo "Memory learner not found."
+    exit 1
+    ;;
+
+  project:manual-init)
+    shift
+
+    if [ -f "$ROOT/dist/src/project-manual/cli.js" ]; then
+      exec node "$ROOT/dist/src/project-manual/cli.js" init "$@"
+    fi
+
+    exec "$TSX" "$ROOT/src/project-manual/cli.ts" init "$@"
+    ;;
+
+  project:manual-show)
+    shift
+
+    if [ -f "$ROOT/dist/src/project-manual/cli.js" ]; then
+      exec node "$ROOT/dist/src/project-manual/cli.js" show "$@"
+    fi
+
+    exec "$TSX" "$ROOT/src/project-manual/cli.ts" show "$@"
+    ;;
+
+  project:manual-sync)
+    shift
+
+    if [ -f "$ROOT/dist/src/project-manual/cli.js" ]; then
+      exec node "$ROOT/dist/src/project-manual/cli.js" sync "$@"
+    fi
+
+    exec "$TSX" "$ROOT/src/project-manual/cli.ts" sync "$@"
+    ;;
+
+  work:status)
+    shift
+
+    if [ -f "$ROOT/dist/src/work-continuity/cli.js" ]; then
+      exec node "$ROOT/dist/src/work-continuity/cli.js" status "$@"
+    fi
+
+    exec "$TSX" "$ROOT/src/work-continuity/cli.ts" status "$@"
+    ;;
+
+  work:json)
+    shift
+
+    if [ -f "$ROOT/dist/src/work-continuity/cli.js" ]; then
+      exec node "$ROOT/dist/src/work-continuity/cli.js" json "$@"
+    fi
+
+    exec "$TSX" "$ROOT/src/work-continuity/cli.ts" json "$@"
+    ;;
+
+  work:reconcile)
+    shift
+
+    if [ -f "$ROOT/dist/src/work-continuity/cli.js" ]; then
+      exec node "$ROOT/dist/src/work-continuity/cli.js" reconcile "$@"
+    fi
+
+    exec "$TSX" "$ROOT/src/work-continuity/cli.ts" reconcile "$@"
+    ;;
+
+  brief)
+    shift
+
+    if [ -f "$ROOT/dist/src/work-continuity/context-cli.js" ]; then
+      exec node "$ROOT/dist/src/work-continuity/context-cli.js" brief "$@"
+    fi
+
+    exec "$TSX" "$ROOT/src/work-continuity/context-cli.ts" brief "$@"
+    ;;
+
+  brief:json)
+    shift
+
+    if [ -f "$ROOT/dist/src/work-continuity/context-cli.js" ]; then
+      exec node "$ROOT/dist/src/work-continuity/context-cli.js" brief-json "$@"
+    fi
+
+    exec "$TSX" "$ROOT/src/work-continuity/context-cli.ts" brief-json "$@"
+    ;;
+
+  handoff:latest)
+    shift
+
+    if [ -f "$ROOT/dist/src/work-continuity/context-cli.js" ]; then
+      exec node "$ROOT/dist/src/work-continuity/context-cli.js" handoff-latest "$@"
+    fi
+
+    exec "$TSX" "$ROOT/src/work-continuity/context-cli.ts" handoff-latest "$@"
+    ;;
+
+  context:sync)
+    shift
+
+    if [ -f "$ROOT/dist/src/work-continuity/context-runtime-cli.js" ]; then
+      exec node "$ROOT/dist/src/work-continuity/context-runtime-cli.js" sync "$@"
+    fi
+
+    exec "$TSX" "$ROOT/src/work-continuity/context-runtime-cli.ts" sync "$@"
+    ;;
+
+  context:print)
+    shift
+
+    if [ -f "$ROOT/dist/src/work-continuity/context-runtime-cli.js" ]; then
+      exec node "$ROOT/dist/src/work-continuity/context-runtime-cli.js" print "$@"
+    fi
+
+    exec "$TSX" "$ROOT/src/work-continuity/context-runtime-cli.ts" print "$@"
+    ;;
+
+  context:refresh)
+    shift
+
+    if [ -f "$ROOT/dist/src/work-continuity/context-runtime-cli.js" ]; then
+      exec node "$ROOT/dist/src/work-continuity/context-runtime-cli.js" refresh "$@"
+    fi
+
+    exec "$TSX" "$ROOT/src/work-continuity/context-runtime-cli.ts" refresh "$@"
+    ;;
+
+  session:codex-context)
+    shift
+
+    if [ -f "$ROOT/dist/src/session/codex/context-hook.js" ]; then
+      exec node "$ROOT/dist/src/session/codex/context-hook.js" "$@"
+    fi
+
+    if [ -x "${TSX:-}" ]; then
+      exec "$TSX" "$ROOT/src/session/codex/context-hook.ts" "$@"
+    fi
+
+    exit 0
+    ;;
+
+  help|--help|-h)
+    cat <<'HELP'
+ToolNet Memory
+
+Commands:
+  toolnet-memory doctor
+  toolnet-memory index
+  toolnet-memory index:graph
+  toolnet-memory incremental
+  toolnet-memory semantic "query"
+  toolnet-memory impact [file]
+  toolnet-memory mcp
+  toolnet-memory snapshot:list
+  toolnet-memory snapshot:create "reason"
+  toolnet-memory snapshot:restore <id>
+  toolnet-memory recover
+  toolnet-memory integrate:opencode
+  toolnet-memory integrate:agy
+  toolnet-memory integrate:codex
+  toolnet-memory session:codex-sync <thread-id>
+  toolnet-memory session:codex-recover [--limit N]
+  toolnet-memory memory:reconcile [--project PATH]
+  toolnet-memory project:manual-init [--project PATH]
+  toolnet-memory project:manual-show [--project PATH]
+  toolnet-memory project:manual-sync [--project PATH]
+  toolnet-memory work:status [--project PATH]
+  toolnet-memory work:json [--project PATH]
+  toolnet-memory work:reconcile [--project PATH]
+  toolnet-memory brief [--project PATH] [--tokens N]
+  toolnet-memory brief:json [--project PATH] [--tokens N]
+  toolnet-memory handoff:latest [--project PATH]
+  toolnet-memory session:agy-sync <conversation-id> --transcript <path>
+  toolnet-memory session:agy-recover [--limit N]
+  toolnet-memory session:opencode-sync <session-id>
+  toolnet-memory session:opencode-recover [--limit N]
+HELP
+    ;;
+
+  *)
+    echo "Unknown command: $COMMAND"
+    echo "Run: toolnet-memory help"
+    exit 1
+    ;;
+esac

package/dist/packages/cli/commands.js

@@ -0,0 +1 @@
+export {};

package/dist/packages/cli/index.js

@@ -0,0 +1 @@
+export {};

package/dist/packages/sdk/client.js

@@ -0,0 +1,78 @@
+export class ToolNetMemoryClient {
+    runtime;
+    autoRetrieval;
+    autoImpactGuard;
+    constructor(runtime, autoRetrieval, autoImpactGuard) {
+        this.runtime = runtime;
+        this.autoRetrieval = autoRetrieval;
+        this.autoImpactGuard = autoImpactGuard;
+    }
+    sessionStart() {
+        return this.runtime
+            .sessionStart();
+    }
+    sessionEnd() {
+        return this.runtime
+            .sessionEnd();
+    }
+    prompt(content) {
+        return this.runtime
+            .userPrompt(content);
+    }
+    preparePrompt(content) {
+        if (!this.autoRetrieval) {
+            return Promise.resolve({
+                originalPrompt: content,
+                context: "",
+                augmentedPrompt: content,
+            });
+        }
+        return this.autoRetrieval
+            .prepare(content);
+    }
+    /*
+     * Đây là hook ToolNet Agent cần gọi
+     * TRƯỚC tool executor.
+     */
+    async beforeTool(tool, input) {
+        const impact = this.autoImpactGuard
+            ? await this.autoImpactGuard
+                .beforeTool(tool, input)
+            : null;
+        await this.runtime
+            .beforeTool(tool, input);
+        return impact;
+    }
+    afterTool(tool, output) {
+        return this.runtime
+            .afterTool(tool, output);
+    }
+    fileRead(filePath) {
+        return this.runtime
+            .fileRead(filePath);
+    }
+    fileWrite(filePath) {
+        return this.runtime
+            .fileWrite(filePath);
+    }
+    command(command, exitCode) {
+        return this.runtime
+            .command(command, exitCode);
+    }
+    error(error) {
+        return this.runtime
+            .error(error);
+    }
+    decision(content) {
+        return this.runtime
+            .decision(content);
+    }
+    todo(content) {
+        return this.runtime
+            .todo(content);
+    }
+    flush() {
+        return this.runtime
+            .flush();
+    }
+}

package/dist/packages/sdk/index.js

@@ -0,0 +1 @@
+export * from "./client.js";

package/dist/packages/sdk/types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/api/index.js

@@ -0,0 +1 @@
+export {};

package/dist/src/api/routes/health.js

@@ -0,0 +1 @@
+export {};

package/dist/src/api/routes/index.js

@@ -0,0 +1 @@
+export {};

package/dist/src/api/routes/memory.js

@@ -0,0 +1 @@
+export {};

package/dist/src/api/routes/projects.js

@@ -0,0 +1 @@
+export {};

package/dist/src/api/routes/search.js

@@ -0,0 +1 @@
+export {};

package/dist/src/api/server.js

@@ -0,0 +1 @@
+export {};