@nalvietnam/avatar-cli 1.0.1 → 1.1.1

package/dist/lib/print-welcome-screen.js

@@ -0,0 +1,117 @@
+// @nalvietnam/avatar-cli — built with tsup
+
+// src/lib/print-welcome-screen.ts
+import boxen from "boxen";
+
+// src/lib/avatar-ascii-banner.ts
+import chalk from "chalk";
+var BANNER_LINES = [
+  " \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557   \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 ",
+  "\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557",
+  "\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551   \u2588\u2588\u2551   \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D",
+  "\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u255A\u2588\u2588\u2557 \u2588\u2588\u2554\u255D\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551   \u2588\u2588\u2551   \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557",
+  "\u2588\u2588\u2551  \u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2554\u255D \u2588\u2588\u2551  \u2588\u2588\u2551   \u2588\u2588\u2551   \u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551",
+  "\u255A\u2550\u255D  \u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u255D  \u255A\u2550\u255D  \u255A\u2550\u255D   \u255A\u2550\u255D   \u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D"
+];
+var GRADIENT_STOPS = [
+  [217, 79, 30],
+  // cam-cháy (#d94f1e)
+  [200, 70, 80],
+  // cam-hồng
+  [170, 70, 140],
+  // hồng-tím
+  [125, 88, 217]
+  // tím (#7d58d9)
+];
+function lerpChannel(a, b, t) {
+  return Math.round(a + (b - a) * t);
+}
+function gradientAt(t) {
+  const clamped = Math.max(0, Math.min(1, t));
+  const scaled = clamped * (GRADIENT_STOPS.length - 1);
+  const lo = Math.floor(scaled);
+  const hi = Math.min(GRADIENT_STOPS.length - 1, lo + 1);
+  const localT = scaled - lo;
+  const a = GRADIENT_STOPS[lo];
+  const b = GRADIENT_STOPS[hi];
+  return [
+    lerpChannel(a[0], b[0], localT),
+    lerpChannel(a[1], b[1], localT),
+    lerpChannel(a[2], b[2], localT)
+  ];
+}
+function renderAvatarBanner(opts) {
+  const isTty = process.stdout.isTTY ?? false;
+  const supportsColor = isTty && chalk.level > 0;
+  if (!supportsColor) {
+    return [...BANNER_LINES, ...opts?.tagline ? ["", opts.tagline] : []].join("\n");
+  }
+  const colored = BANNER_LINES.map((line, idx) => {
+    const t = BANNER_LINES.length === 1 ? 0 : idx / (BANNER_LINES.length - 1);
+    const [r, g, b] = gradientAt(t);
+    return chalk.rgb(r, g, b).bold(line);
+  });
+  if (opts?.tagline) {
+    colored.push("");
+    colored.push(chalk.dim(opts.tagline));
+  }
+  return colored.join("\n");
+}
+function printAvatarBanner(opts) {
+  process.stdout.write(`
+${renderAvatarBanner(opts)}
+
+`);
+}
+
+// src/lib/terminal-logger.ts
+import chalk2 from "chalk";
+import ora from "ora";
+
+// src/lib/print-welcome-screen.ts
+var COMMANDS = [
+  { name: "login", desc: "\u0110\u0103ng nh\u1EADp Google SSO (@nal.vn)" },
+  { name: "init", desc: "Kh\u1EDFi t\u1EA1o Avatar \u2014 3 flow t\u1EF1 nh\u1EADn di\u1EC7n" },
+  { name: "sync", desc: "Pull team-ai-pack m\u1EDBi nh\u1EA5t" },
+  { name: "scan", desc: "Project scanner + knowledge proposal" },
+  { name: "review", desc: "Duy\u1EC7t pending proposals" },
+  { name: "status", desc: "Snapshot project, pack, pending, backup" },
+  { name: "doctor", desc: "Ch\u1EA9n \u0111o\xE1n c\xE0i \u0111\u1EB7t Avatar" },
+  { name: "restore", desc: "Kh\xF4i ph\u1EE5c .claude/pack/ t\u1EEB backup" },
+  { name: "commit", desc: "Commit src/ ho\u1EB7c Avatar state (client mode)" },
+  { name: "tools", desc: "Qu\u1EA3n l\xFD system tools + MCP servers" },
+  { name: "secrets", desc: "Qu\u1EA3n l\xFD secrets trong OS keychain" },
+  { name: "uninstall", desc: "G\u1EE1 Avatar kh\u1ECFi project + backup" },
+  { name: "help", desc: "Hi\u1EC3n th\u1ECB help cho t\u1EEBng l\u1EC7nh" }
+];
+var CLI_VERSION = "1.1.1";
+function printWelcomeScreen() {
+  printAvatarBanner({ tagline: `v${CLI_VERSION} \xB7 AI harness CLI for NAL Vietnam` });
+  const maxNameWidth = Math.max(...COMMANDS.map((c) => c.name.length));
+  const commandLines = COMMANDS.map((c) => {
+    const padded = c.name.padEnd(maxNameWidth);
+    return `  ${chalk2.cyan(padded)}   ${chalk2.dim(c.desc)}`;
+  }).join("\n");
+  const nextSteps = [
+    "",
+    chalk2.bold("13 l\u1EC7nh s\u1EB5n s\xE0ng:"),
+    "",
+    commandLines,
+    "",
+    chalk2.bold("Next steps:"),
+    "",
+    `  ${chalk2.green("1.")} ${chalk2.cyan("avatar login")}                    \u0110\u0103ng nh\u1EADp SSO`,
+    `  ${chalk2.green("2.")} ${chalk2.cyan("avatar init")}                     Kh\u1EDFi t\u1EA1o d\u1EF1 \xE1n`,
+    `  ${chalk2.green("?.")} ${chalk2.cyan("avatar <command> --help")}         Xem chi ti\u1EBFt l\u1EC7nh`,
+    "",
+    chalk2.dim("Docs: https://www.npmjs.com/package/@nalvietnam/avatar-cli")
+  ].join("\n");
+  process.stdout.write(
+    `${boxen(nextSteps, { padding: 1, borderStyle: "round", borderColor: "magenta" })}
+`
+  );
+}
+export {
+  printWelcomeScreen
+};
+//# sourceMappingURL=print-welcome-screen.js.map

package/dist/lib/print-welcome-screen.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/print-welcome-screen.ts","../../src/lib/avatar-ascii-banner.ts","../../src/lib/terminal-logger.ts"],"sourcesContent":["// Welcome screen in ra sau `npm install -g` (qua postinstall hook) hoặc khi\n// user gọi `avatar welcome` thủ công. Mục đích: cho user thấy banner + 13\n// commands + next step gợi ý ngay sau khi cài.\nimport boxen from \"boxen\";\nimport { printAvatarBanner } from \"./avatar-ascii-banner.js\";\nimport { chalk } from \"./terminal-logger.js\";\n\ninterface CommandSummary {\n  name: string;\n  desc: string;\n}\n\n// Danh sách 13 commands user-facing (mcp-run là hidden, bỏ qua).\nconst COMMANDS: CommandSummary[] = [\n  { name: \"login\", desc: \"Đăng nhập Google SSO (@nal.vn)\" },\n  { name: \"init\", desc: \"Khởi tạo Avatar — 3 flow tự nhận diện\" },\n  { name: \"sync\", desc: \"Pull team-ai-pack mới nhất\" },\n  { name: \"scan\", desc: \"Project scanner + knowledge proposal\" },\n  { name: \"review\", desc: \"Duyệt pending proposals\" },\n  { name: \"status\", desc: \"Snapshot project, pack, pending, backup\" },\n  { name: \"doctor\", desc: \"Chẩn đoán cài đặt Avatar\" },\n  { name: \"restore\", desc: \"Khôi phục .claude/pack/ từ backup\" },\n  { name: \"commit\", desc: \"Commit src/ hoặc Avatar state (client mode)\" },\n  { name: \"tools\", desc: \"Quản lý system tools + MCP servers\" },\n  { name: \"secrets\", desc: \"Quản lý secrets trong OS keychain\" },\n  { name: \"uninstall\", desc: \"Gỡ Avatar khỏi project + backup\" },\n  { name: \"help\", desc: \"Hiển thị help cho từng lệnh\" },\n];\n\nconst CLI_VERSION = \"1.1.1\";\n\nexport function printWelcomeScreen(): void {\n  printAvatarBanner({ tagline: `v${CLI_VERSION} · AI harness CLI for NAL Vietnam` });\n\n  // Tính độ rộng max của tên command để align cột.\n  const maxNameWidth = Math.max(...COMMANDS.map((c) => c.name.length));\n\n  const commandLines = COMMANDS.map((c) => {\n    const padded = c.name.padEnd(maxNameWidth);\n    return `  ${chalk.cyan(padded)}   ${chalk.dim(c.desc)}`;\n  }).join(\"\\n\");\n\n  const nextSteps = [\n    \"\",\n    chalk.bold(\"13 lệnh sẵn sàng:\"),\n    \"\",\n    commandLines,\n    \"\",\n    chalk.bold(\"Next steps:\"),\n    \"\",\n    `  ${chalk.green(\"1.\")} ${chalk.cyan(\"avatar login\")}                    Đăng nhập SSO`,\n    `  ${chalk.green(\"2.\")} ${chalk.cyan(\"avatar init\")}                     Khởi tạo dự án`,\n    `  ${chalk.green(\"?.\")} ${chalk.cyan(\"avatar <command> --help\")}         Xem chi tiết lệnh`,\n    \"\",\n    chalk.dim(\"Docs: https://www.npmjs.com/package/@nalvietnam/avatar-cli\"),\n  ].join(\"\\n\");\n\n  process.stdout.write(\n    `${boxen(nextSteps, { padding: 1, borderStyle: \"round\", borderColor: \"magenta\" })}\\n`,\n  );\n}\n\n// Caller (bin/postinstall.js) chịu trách nhiệm gọi printWelcomeScreen() —\n// không auto-execute ở đây để tránh in trùng khi module được import từ postinstall.\n","// Avatar ASCII banner — gradient màu cam → tím để in ở các entry point chính:\n// `avatar --version`, `avatar init`, `avatar login`.\n//\n// Style: ANSI Shadow block characters (Unicode box-drawing).\n// Tự fallback sang plain text khi không phải TTY (CI, pipe ra file).\nimport chalk from \"chalk\";\n\n// 6 dòng chính của logo, mỗi dòng giữ độ rộng đồng nhất 50 ký tự để gradient đẹp.\nconst BANNER_LINES: readonly string[] = [\n  \" █████╗ ██╗   ██╗ █████╗ ████████╗ █████╗ ██████╗ \",\n  \"██╔══██╗██║   ██║██╔══██╗╚══██╔══╝██╔══██╗██╔══██╗\",\n  \"███████║██║   ██║███████║   ██║   ███████║██████╔╝\",\n  \"██╔══██║╚██╗ ██╔╝██╔══██║   ██║   ██╔══██║██╔══██╗\",\n  \"██║  ██║ ╚████╔╝ ██║  ██║   ██║   ██║  ██║██║  ██║\",\n  \"╚═╝  ╚═╝  ╚═══╝  ╚═╝  ╚═╝   ╚═╝   ╚═╝  ╚═╝╚═╝  ╚═╝\",\n] as const;\n\n// Gradient stops cam → tím (RGB triples). Mỗi dòng nội suy theo % chiều cao.\nconst GRADIENT_STOPS: ReadonlyArray<readonly [number, number, number]> = [\n  [217, 79, 30], // cam-cháy (#d94f1e)\n  [200, 70, 80], // cam-hồng\n  [170, 70, 140], // hồng-tím\n  [125, 88, 217], // tím (#7d58d9)\n];\n\n// Nội suy tuyến tính 1 kênh màu giữa 2 stop.\nfunction lerpChannel(a: number, b: number, t: number): number {\n  return Math.round(a + (b - a) * t);\n}\n\n// Lấy màu RGB tại vị trí [0,1] trên gradient.\nfunction gradientAt(t: number): readonly [number, number, number] {\n  const clamped = Math.max(0, Math.min(1, t));\n  const scaled = clamped * (GRADIENT_STOPS.length - 1);\n  const lo = Math.floor(scaled);\n  const hi = Math.min(GRADIENT_STOPS.length - 1, lo + 1);\n  const localT = scaled - lo;\n  const a = GRADIENT_STOPS[lo];\n  const b = GRADIENT_STOPS[hi];\n  return [\n    lerpChannel(a[0], b[0], localT),\n    lerpChannel(a[1], b[1], localT),\n    lerpChannel(a[2], b[2], localT),\n  ];\n}\n\n// Build banner string đã tô màu sẵn. Trả empty khi terminal không hỗ trợ màu.\nexport function renderAvatarBanner(opts?: { tagline?: string }): string {\n  const isTty = process.stdout.isTTY ?? false;\n  const supportsColor = isTty && chalk.level > 0;\n\n  // Plain fallback cho CI hoặc pipe.\n  if (!supportsColor) {\n    return [...BANNER_LINES, ...(opts?.tagline ? [\"\", opts.tagline] : [])].join(\"\\n\");\n  }\n\n  const colored = BANNER_LINES.map((line, idx) => {\n    const t = BANNER_LINES.length === 1 ? 0 : idx / (BANNER_LINES.length - 1);\n    const [r, g, b] = gradientAt(t);\n    return chalk.rgb(r, g, b).bold(line);\n  });\n\n  if (opts?.tagline) {\n    colored.push(\"\");\n    colored.push(chalk.dim(opts.tagline));\n  }\n\n  return colored.join(\"\\n\");\n}\n\n// Tiện ích: in banner ra stdout với newline phía trước/sau cho thoáng.\nexport function printAvatarBanner(opts?: { tagline?: string }): void {\n  process.stdout.write(`\\n${renderAvatarBanner(opts)}\\n\\n`);\n}\n","// Terminal logging helpers — chalk for color, ora for spinners.\n// All Avatar CLI output should funnel through here for consistent UX.\nimport chalk from \"chalk\";\nimport ora, { type Ora } from \"ora\";\n\ntype LogFn = (message: string) => void;\n\nexport const log: {\n  info: LogFn;\n  success: LogFn;\n  warn: LogFn;\n  error: LogFn;\n  dim: LogFn;\n  plain: LogFn;\n} = {\n  info: (m) => process.stdout.write(`${chalk.blue(\"ℹ\")} ${m}\\n`),\n  success: (m) => process.stdout.write(`${chalk.green(\"✓\")} ${m}\\n`),\n  warn: (m) => process.stdout.write(`${chalk.yellow(\"⚠\")} ${m}\\n`),\n  error: (m) => process.stderr.write(`${chalk.red(\"✗\")} ${m}\\n`),\n  dim: (m) => process.stdout.write(`${chalk.dim(m)}\\n`),\n  plain: (m) => process.stdout.write(`${m}\\n`),\n};\n\n// Spinner wrapper — handles non-TTY by degrading to plain output.\nexport function spinner(text: string): Ora {\n  return ora({\n    text,\n    spinner: \"dots\",\n    isEnabled: process.stdout.isTTY ?? false,\n  }).start();\n}\n\n// Chalk re-export so commands don't all import chalk separately.\nexport { chalk };\n"],"mappings":"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","names":["chalk","chalk"]}

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.1",
   "description": "AI harness CLI for NAL Vietnam engineering",
   "type": "module",
   "bin": {
@@ -25,7 +25,8 @@
     "test:all": "npm run build && vitest run --passWithNoTests",
     "lint": "biome check src test",
     "format": "biome format --write src test",
-    "prepublishOnly": "npm run build && npm run test:all"
+    "prepublishOnly": "npm run build && npm run test:all",
+    "postinstall": "node ./bin/postinstall.js"
   },
   "dependencies": {
     "@inquirer/prompts": "^8.4.3",

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