@dtt_siye/atool 1.2.0 → 1.3.0

package/README.md

@@ -1,14 +1,18 @@
 # aTool - AI 开发者工具集
 
-[![Version](https://img.shields.io/badge/version-0.3.0-blue.svg)](VERSION)
+[![npm version](https://img.shields.io/npm/v/@dtt_siye/atool.svg)](https://www.npmjs.com/package/@dtt_siye/atool)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![Shell](https://img.shields.io/badge/shell-bash-4EAA25.svg)](install.sh)
 
 > 一键配置 AI IDE 的 Skills、MCP Servers、Hooks 和项目规则。让任何水平的开发者，通过在 IDE 中正常聊天，就能获得资深架构师的判断力、高级工程师的代码质量标准、和技术文档专家的交付质量。
 
-**一条命令，30 秒完成配置：**
+**两种安装方式，30 秒完成配置：**
 
 ```bash
+# 方式一：npm 安装（推荐，全局可用）
+npx @dtt_siye/atool
+
+# 方式二：从源码安装
 git clone --recursive https://github.com/user/atool.git && cd atool
 ./install.sh --all --yes
 ```
@@ -36,6 +40,20 @@ git clone --recursive https://github.com/user/atool.git && cd atool
 
 ## 快速开始
 
+### npm 安装（推荐）
+
+```bash
+# 一键安装到所有 IDE
+npx @dtt_siye/atool
+
+# 或全局安装后使用
+npm install -g @dtt_siye/atool
+atool                    # 安装到所有 IDE
+atool --project ./my-app # 初始化项目
+```
+
+### 从源码安装
+
 ```bash
 # 1. 安装到所有 IDE
 ./install.sh --all --yes
@@ -161,14 +179,16 @@ Java/Spring, React/Next.js, Vue/Nuxt, Svelte, Python, Go, Rust/Tauri, Android, i
 ## 更新与卸载
 
 ```bash
-# 更新（一步式：拉取代码 + 自动重装变更组件）
-./install.sh --update
-
-# 检查更新
-./install.sh --check-updates
-
-# 卸载（动态扫描并移除所有 aTool 组件）
-./install.sh --uninstall
+# npm 方式
+npm update -g @dtt_siye/atool    # 更新
+atool --all --yes                # 重新安装
+npm uninstall -g @dtt_siye/atool # 卸载 npm 包
+atool --uninstall                # 移除配置
+
+# 源码方式
+./install.sh --update            # 一步式更新
+./install.sh --check-updates     # 检查更新
+./install.sh --uninstall         # 移除配置
 ```
 
 更新策略：Skills 按内容 checksum 增量更新，Cursor/Kiro staging 按 checksum 比较，MCP 使用 JSON 深度合并，Hooks 按 MD5 校验。详见 [docs/09-architecture.md](docs/09-architecture.md)。

package/VERSION

@@ -1 +1 @@
-0.3.0
+1.3.0

package/hooks/session-start

@@ -190,24 +190,21 @@ if $IS_PROJECT && declare -f detect_stack &>/dev/null; then
 
     PROJECT_CONTEXT+="</ATOOL-PROJECT-CONTEXT>"
 
-    # Doc sync reminder — hard rule with skill enforcement
-    DOC_SYNC="<ATOOL-DOC-SYNC>"
+    # Hard rules — non-bypassable gates extracted from skills
+    # These apply in ALL modes: normal, Plan Mode, etc.
+    DOC_SYNC="<ATOOL-HARD-RULES>"
     DOC_SYNC+=$'\n'
-    DOC_SYNC+="HARD RULE: Every time you modify a source file, you MUST update affected documentation BEFORE claiming the task is done."
+    DOC_SYNC+="Three NON-NEGOTIABLE rules that apply in ALL modes (Plan Mode, normal mode, etc.):"
     DOC_SYNC+=$'\n\n'
-    DOC_SYNC+="Mandatory actions when source files change:"
+    DOC_SYNC+="1. **Doc Sync Gate**: After modifying any source file, update affected docs (README.md, COMPONENT.md, UI_STYLE.md, docs/) BEFORE claiming done. If docs stale -> task NOT done."
     DOC_SYNC+=$'\n'
-    DOC_SYNC+="1. Update affected docs: README.md (architecture/structure), COMPONENT.md (API/usage), UI_STYLE.md (styles), docs/ (knowledge base)."
+    DOC_SYNC+="2. **Verification Gate**: Before claiming complete: (a) tests pass, (b) docs fresh, (c) no critical issues. Any fail -> task NOT done. Invoke /verification-before-completion."
     DOC_SYNC+=$'\n'
-    DOC_SYNC+="2. BEFORE claiming task done, invoke /verification-before-completion — this skill checks doc freshness and blocks completion if docs are stale."
-    DOC_SYNC+=$'\n'
-    DOC_SYNC+="3. For doc writing, invoke /doc-coauthoring. For doc format validation, invoke /doc-standards-enforcer."
+    DOC_SYNC+="3. **Root Cause Gate**: When debugging, identify root cause BEFORE writing fix. Never guess-fix. See /systematic-debugging."
     DOC_SYNC+=$'\n\n'
-    DOC_SYNC+="When writing plans: always include a Documentation Sync step as the final task."
-    DOC_SYNC+=$'\n'
-    DOC_SYNC+="Gate rule: if docs are stale, task is NOT done. No exceptions."
+    DOC_SYNC+="When writing plans (any mode): MUST include a final Documentation Sync task. Plans without it are INCOMPLETE."
     DOC_SYNC+=$'\n'
-    DOC_SYNC+="</ATOOL-DOC-SYNC>"
+    DOC_SYNC+="</ATOOL-HARD-RULES>"
 fi
 
 # ═══════════════════════════════════════════════════════════════════════════

package/lib/export-analysis.sh

@@ -0,0 +1,100 @@
+#!/usr/bin/env bash
+# lib/export-analysis.sh — Project analysis export and registry management
+#
+# Manages ~/.atool/projects.json, the global registry of analyzed projects.
+# Called by Phase 5 (EXPORT) of project-analyze skill.
+#
+# Functions:
+#   register_project(project_root)   — Add/update project in ~/.atool/projects.json
+#   list_projects()                  — List all registered projects
+#   unregister_project(project_root) — Remove project from registry
+set -euo pipefail
+
+ATOOL_HOME="${HOME}/.atool"
+PROJECTS_REGISTRY="${ATOOL_HOME}/projects.json"
+
+# _init_registry: Create registry file if it doesn't exist
+_init_registry() {
+    mkdir -p "$ATOOL_HOME"
+    if [ ! -f "$PROJECTS_REGISTRY" ]; then
+        echo '{"version":"1.0","projects":[]}' > "$PROJECTS_REGISTRY"
+    fi
+}
+
+# register_project: Add or update a project in the global registry
+# Args: $1 = project_root (absolute path to analyzed project)
+# Reads: $project_root/atool-analysis/manifest.json
+register_project() {
+    local project_root="${1:?register_project: project_root required}"
+    local manifest="$project_root/atool-analysis/manifest.json"
+
+    if [ ! -f "$manifest" ]; then
+        echo "Warning: manifest.json not found at $manifest, skipping registry" >&2
+        return 0
+    fi
+
+    _init_registry
+
+    local name stack depth module_count file_count analyzed_at version
+    name=$(jq -r '.name // "unknown"' "$manifest")
+    stack=$(jq -r '.stack // "unknown"' "$manifest")
+    depth=$(jq -r '.depth // "L2"' "$manifest")
+    module_count=$(jq -r '.module_count // 0' "$manifest")
+    file_count=$(jq -r '.file_count // 0' "$manifest")
+    analyzed_at=$(jq -r '.analyzed_at // ""' "$manifest")
+    version=$(jq -r '.analysis_version // "5.1.0"' "$manifest")
+
+    # Build new entry JSON
+    local new_entry
+    new_entry=$(jq -n \
+        --arg path "$project_root" \
+        --arg name "$name" \
+        --arg stack "$stack" \
+        --arg depth "$depth" \
+        --argjson module_count "$module_count" \
+        --argjson file_count "$file_count" \
+        --arg analyzed_at "$analyzed_at" \
+        --arg version "$version" \
+        '{
+            path: $path,
+            name: $name,
+            stack: $stack,
+            depth: $depth,
+            module_count: $module_count,
+            file_count: $file_count,
+            analyzed_at: $analyzed_at,
+            analysis_version: $version
+        }')
+
+    # Upsert: remove existing entry with same path, then add new one
+    jq --argjson entry "$new_entry" \
+        '.projects = ([.projects[] | select(.path != $entry.path)] + [$entry])' \
+        "$PROJECTS_REGISTRY" > "${PROJECTS_REGISTRY}.tmp" \
+        && mv "${PROJECTS_REGISTRY}.tmp" "$PROJECTS_REGISTRY"
+
+    echo "Project registered: $name ($stack) → $PROJECTS_REGISTRY"
+}
+
+# list_projects: Print all registered projects (one per line)
+list_projects() {
+    _init_registry
+    local count
+    count=$(jq '.projects | length' "$PROJECTS_REGISTRY" 2>/dev/null || echo 0)
+    if [ "$count" -eq 0 ]; then
+        echo "No projects registered yet"
+        return 0
+    fi
+    jq -r '.projects[] | "\(.name) [\(.stack)] \(.depth) — \(.path)"' "$PROJECTS_REGISTRY"
+}
+
+# unregister_project: Remove a project from the registry by path
+# Args: $1 = project_root (absolute path)
+unregister_project() {
+    local project_root="${1:?unregister_project: project_root required}"
+    _init_registry
+    jq --arg path "$project_root" \
+        '.projects = [.projects[] | select(.path != $path)]' \
+        "$PROJECTS_REGISTRY" > "${PROJECTS_REGISTRY}.tmp" \
+        && mv "${PROJECTS_REGISTRY}.tmp" "$PROJECTS_REGISTRY"
+    echo "Project unregistered: $project_root"
+}

package/lib/install-kiro.sh

@@ -314,15 +314,20 @@ MDFRONT
     # Append skill catalog (no indentation)
     cat >> "$md_file" <<< "$skills_catalog"
 
-    # Append doc-sync rules (clarify rules are in core-workflow's clarify-before-build skill — no duplicate)
+    # Append hard rules (extracted from skills, non-bypassable in all modes)
     cat >> "$md_file" <<'RULES'
 
-## Document Sync (HARD RULE)
+## aTool Hard Rules (Non-bypassable)
 
-Every time you modify a source file (.ts/.tsx/.js/.jsx/.vue/.svelte/.rs/.py/.go/.java/.kt/.swift/.dart/.ets/.sh):
-1. Check if README.md, COMPONENT.md, UI_STYLE.md, or docs/ need updating
-2. If docs are stale (source files newer than docs), update them BEFORE claiming task is done
-3. If docs are stale, the task is NOT complete — this is a gate, not a suggestion
+Three NON-NEGOTIABLE rules that apply in ALL modes (Plan Mode, normal mode, etc.):
+
+1. **Doc Sync Gate**: After modifying any source file, update affected docs (README.md, COMPONENT.md, UI_STYLE.md, docs/) BEFORE claiming done. If docs stale -> task NOT done.
+
+2. **Verification Gate**: Before claiming complete: (a) tests pass, (b) docs fresh, (c) no critical issues. Any fail -> task NOT done. Invoke /verification-before-completion.
+
+3. **Root Cause Gate**: When debugging, identify root cause BEFORE writing fix. Never guess-fix. See /systematic-debugging.
+
+When writing plans (any mode): MUST include a final Documentation Sync task. Plans without it are INCOMPLETE.
 
 ## On-Demand Skills
 

package/lib/knowledge-graph.sh

@@ -410,11 +410,16 @@ compute_edge_weights() {
     base_weights='{
         "depends_on": 1.0, "calls": 0.9, "calls_async": 0.8,
         "reads_state": 0.8, "writes_state": 0.8, "reads_from": 0.8,
-        "writes_to": 0.8, "transforms": 0.7, "validates": 0.6,
+        "writes_to": 1.2, "transforms": 0.7, "validates": 0.6,
         "renders": 1.0, "routes_to": 1.0, "sends_http": 1.0,
         "receives_http": 1.0, "persists_to": 0.9, "subscribes_to": 0.8,
         "emits": 1.0, "listens_to": 1.0, "returns": 0.7,
-        "implements": 1.0, "extends": 1.0
+        "implements": 1.0, "extends": 1.0,
+        "configures": 0.6, "imports": 0.8,
+        "tests": 0.4, "mocks": 0.3,
+        "inherits": 1.0, "delegates": 0.9,
+        "contains": 0.5, "layer_depends": 0.7,
+        "publishes": 0.8, "subscribes": 0.8
     }'
 
     local result

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dtt_siye/atool",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "AI Developer Toolkit - 一键配置 AI IDE 的工具集",
   "bin": {
     "atool": "bin/atool.js"