@dtt_siye/atool 1.2.1 → 1.3.1

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/install-skills.sh

@@ -118,6 +118,22 @@ install_skills() {
         run_cmd cp -r "$skill_dir" "$target_skill"
         write_skill_version_marker "$target_skill" "$source_ver"
 
+        # Copy referenced lib/ scripts into skill's lib/ subdirectory
+        # Skills reference scripts via "source lib/X.sh" relative to the skill dir
+        local skill_lib_dir="$target_skill/lib"
+        local referenced_libs
+        referenced_libs=$(find "$target_skill/phases" "$target_skill" -maxdepth 2 -name '*.md' -exec grep -roh 'source lib/[^ ]*\.sh' {} + 2>/dev/null \
+            | sed 's/source lib\///' | sort -u)
+        if [[ -n "$referenced_libs" ]]; then
+            run_cmd mkdir -p "$skill_lib_dir"
+            for lib_name in $referenced_libs; do
+                local lib_src="$atool_root/lib/$lib_name"
+                if [[ -f "$lib_src" ]]; then
+                    run_cmd cp "$lib_src" "$skill_lib_dir/$lib_name"
+                fi
+            done
+        fi
+
         if [[ "$installed_ver" != "none" ]] && [[ "$installed_ver" != "$source_ver" ]]; then
             log_info "Updated skill: $skill_name"
         else