@nalvietnam/avatar-cli 1.0.1 → 1.1.0

package/dist/templates/CLAUDE.md.tpl

@@ -0,0 +1,40 @@
+# {{projectName}}
+
+{{projectDescription}}
+
+## Context cho Claude Code
+
+File này là entry point. Claude Code đọc file này và resolve các @-imports bên dưới
+để có toàn bộ context dự án. KHÔNG sửa file này thủ công; chạy `avatar scan`
+và `avatar review` để cập nhật.
+
+### Knowledge nền tảng (từ team-ai-pack)
+
+@.claude/pack/knowledge/org/coding-standards.md
+@.claude/pack/knowledge/org/git-workflow.md
+@.claude/pack/knowledge/org/security-policy.md
+
+### Knowledge dự án này (auto-scan)
+
+@.claude/project/tech-stack.md
+@.claude/project/conventions.md
+@.claude/project/architecture.md
+@.claude/project/domain.md
+@.claude/project/gotchas.md
+
+### Hướng dẫn cho Claude
+
+- Tuân thủ convention trong @.claude/project/conventions.md trước, sau đó tới
+  @.claude/pack/knowledge/org/coding-standards.md.
+- Khi tạo file mới, đặt theo pattern trong @.claude/project/architecture.md.
+- Khi gặp gotcha mới, đề xuất ghi vào @.claude/project/gotchas.md.
+- Câu hỏi quy trình: đọc @.claude/pack/knowledge/playbooks/
+- Quyết định kiến trúc lớn: tham khảo @.claude/pack/knowledge/decisions/
+
+### Project metadata
+
+- Team owner: {{teamOwner}}
+- Avatar version: {{avatarVersion}}
+- Pack version: {{packVersion}}
+- Last scan: {{lastScan}}
+- Mode: {{mode}}

package/dist/templates/gitignore/generic.txt

@@ -0,0 +1,20 @@
+# OS
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# Editors
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Env
+.env
+.env.local
+.env.*.local
+
+# Logs
+*.log
+logs/

package/dist/templates/gitignore/go.txt

@@ -0,0 +1,16 @@
+# Go
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+*.test
+*.out
+
+# Build artifacts
+bin/
+vendor/
+
+# Coverage
+coverage.txt
+*.cov

package/dist/templates/gitignore/java.txt

@@ -0,0 +1,23 @@
+# Java
+*.class
+*.jar
+*.war
+*.nar
+*.ear
+*.zip
+*.tar.gz
+*.rar
+hs_err_pid*
+
+# Gradle
+.gradle/
+build/
+
+# Maven
+target/
+
+# IDE
+.classpath
+.project
+.settings/
+.metadata/

package/dist/templates/gitignore/node.txt

@@ -0,0 +1,21 @@
+# Node
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+.pnpm-store/
+
+# Build outputs
+dist/
+build/
+out/
+.next/
+.nuxt/
+.turbo/
+coverage/
+
+# Cache
+.cache/
+.parcel-cache/
+.eslintcache

package/dist/templates/gitignore/python.txt

@@ -0,0 +1,26 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+
+# Virtual envs
+venv/
+.venv/
+env/
+.env/
+ENV/
+
+# Build
+build/
+dist/
+*.egg-info/
+.eggs/
+
+# Test/coverage
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.mypy_cache/
+.ruff_cache/

package/dist/templates/gitignore/ruby.txt

@@ -0,0 +1,16 @@
+# Ruby
+*.gem
+*.rbc
+.bundle/
+.config
+vendor/bundle/
+
+# Logs
+log/*.log
+tmp/
+
+# Test
+coverage/
+spec/reports/
+test/tmp/
+test/version_tmp/

package/dist/templates/gitignore/rust.txt

@@ -0,0 +1,5 @@
+# Rust
+target/
+**/*.rs.bk
+Cargo.lock
+*.pdb

package/dist/templates/gitignore.tpl

@@ -0,0 +1,4 @@
+# Avatar — git-ignored entries injected on `avatar init`
+.claude/_pending/
+.claude/_backup/
+.claude/state/session-*.json

package/dist/templates/project/architecture.md.tpl

@@ -0,0 +1,27 @@
+# Architecture — {{projectName}}
+
+> File này do `avatar scan` cập nhật. KHÔNG sửa thủ công.
+
+## Tổng quan kiến trúc
+
+{{architectureOverview}}
+
+## Layer / Module chính
+
+{{moduleLayout}}
+
+## Data flow
+
+{{dataFlow}}
+
+## External integration
+
+{{externalIntegrations}}
+
+## Deployment topology
+
+{{deploymentTopology}}
+
+---
+
+*Generated: {{lastScan}} · Avatar v{{avatarVersion}}*

package/dist/templates/project/conventions.md.tpl

@@ -0,0 +1,27 @@
+# Conventions — {{projectName}}
+
+> File này do `avatar scan` cập nhật. KHÔNG sửa thủ công.
+
+## Code style
+
+{{codeStyle}}
+
+## Naming convention
+
+{{namingConvention}}
+
+## Folder structure
+
+{{folderStructure}}
+
+## Commit message
+
+{{commitConvention}}
+
+## Linter / Formatter
+
+{{linterConfig}}
+
+---
+
+*Generated: {{lastScan}} · Avatar v{{avatarVersion}}*

package/dist/templates/project/domain.md.tpl

@@ -0,0 +1,23 @@
+# Domain — {{projectName}}
+
+> File này do `avatar scan` cập nhật. KHÔNG sửa thủ công.
+
+## Mô tả domain
+
+{{domainDescription}}
+
+## Khái niệm chính
+
+{{coreEntities}}
+
+## Use case chính
+
+{{primaryUseCases}}
+
+## Glossary
+
+{{domainGlossary}}
+
+---
+
+*Generated: {{lastScan}} · Avatar v{{avatarVersion}}*

package/dist/templates/project/gotchas.md.tpl

@@ -0,0 +1,28 @@
+# Gotchas — {{projectName}}
+
+> File tự đầy theo thời gian qua skill `knowledge-capture`. Bẫy quan trọng,
+> bài học kinh nghiệm sẽ tích lũy ở đây.
+
+## Cấu trúc một mục gotcha
+
+```
+### [Tag] Tên ngắn gọn
+
+**Triệu chứng:** Lỗi gì xuất hiện.
+
+**Nguyên nhân:** Vì sao xảy ra.
+
+**Cách tránh:** Làm thế nào để không lặp lại.
+
+**Tham khảo:** Link PR, issue, commit.
+```
+
+---
+
+## Bẫy đã ghi nhận
+
+*(Chưa có gotcha nào — Avatar sẽ tự bổ sung khi gặp pattern lặp lại trong session.)*
+
+---
+
+*Last updated: {{lastScan}} · Avatar v{{avatarVersion}}*

package/dist/templates/project/tech-stack.md.tpl

@@ -0,0 +1,32 @@
+# Tech stack — {{projectName}}
+
+> File này do `avatar scan` cập nhật. KHÔNG sửa thủ công. Đề xuất thay đổi
+> qua `avatar review`.
+
+## Ngôn ngữ chính
+
+{{primaryLanguage}}
+
+## Framework / Library
+
+{{frameworks}}
+
+## Database
+
+{{databases}}
+
+## Test stack
+
+{{testStack}}
+
+## Build & deploy
+
+{{buildStack}}
+
+## Phiên bản công cụ
+
+{{toolVersions}}
+
+---
+
+*Generated: {{lastScan}} · Avatar v{{avatarVersion}}*

package/dist/templates/settings.json.tpl

@@ -0,0 +1,32 @@
+{
+  "allowedTools": [
+    "Bash(npm:*)",
+    "Bash(pnpm:*)",
+    "Bash(git:*)",
+    "Bash(node:*)",
+    "Edit",
+    "Read",
+    "Write",
+    "Glob",
+    "Grep"
+  ],
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "avatar internal post-edit",
+            "timeout": 5
+          }
+        ]
+      }
+    ]
+  },
+  "env": {
+    "AVATAR_PROJECT": "{{projectName}}",
+    "AVATAR_OWNER": "{{teamOwner}}",
+    "AVATAR_MODE": "{{mode}}"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nalvietnam/avatar-cli",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "AI harness CLI for NAL Vietnam engineering",
   "type": "module",
   "bin": {

package/src/templates/gitignore/generic.txt

@@ -0,0 +1,20 @@
+# OS
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# Editors
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Env
+.env
+.env.local
+.env.*.local
+
+# Logs
+*.log
+logs/

package/src/templates/gitignore/go.txt

@@ -0,0 +1,16 @@
+# Go
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+*.test
+*.out
+
+# Build artifacts
+bin/
+vendor/
+
+# Coverage
+coverage.txt
+*.cov

package/src/templates/gitignore/java.txt

@@ -0,0 +1,23 @@
+# Java
+*.class
+*.jar
+*.war
+*.nar
+*.ear
+*.zip
+*.tar.gz
+*.rar
+hs_err_pid*
+
+# Gradle
+.gradle/
+build/
+
+# Maven
+target/
+
+# IDE
+.classpath
+.project
+.settings/
+.metadata/

package/src/templates/gitignore/node.txt

@@ -0,0 +1,21 @@
+# Node
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+.pnpm-store/
+
+# Build outputs
+dist/
+build/
+out/
+.next/
+.nuxt/
+.turbo/
+coverage/
+
+# Cache
+.cache/
+.parcel-cache/
+.eslintcache

package/src/templates/gitignore/python.txt

@@ -0,0 +1,26 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+
+# Virtual envs
+venv/
+.venv/
+env/
+.env/
+ENV/
+
+# Build
+build/
+dist/
+*.egg-info/
+.eggs/
+
+# Test/coverage
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.mypy_cache/
+.ruff_cache/

package/src/templates/gitignore/ruby.txt

@@ -0,0 +1,16 @@
+# Ruby
+*.gem
+*.rbc
+.bundle/
+.config
+vendor/bundle/
+
+# Logs
+log/*.log
+tmp/
+
+# Test
+coverage/
+spec/reports/
+test/tmp/
+test/version_tmp/

package/src/templates/gitignore/rust.txt

@@ -0,0 +1,5 @@
+# Rust
+target/
+**/*.rs.bk
+Cargo.lock
+*.pdb