@damphuquy/agent-init 1.0.0 → 1.0.2

package/README.md

@@ -1,105 +1,90 @@
-# RIPER-5 Coding Agents & Operational Workspace Scaffolder
+# @damphuquy/agent-init
 
-Bộ công cụ khởi tạo bộ khung System Prompt / Agent Manual (`AGENTS.md`) và Operational Workspace (`process/`) cho bất kỳ subsystem hoặc repository nào.
+Bộ công cụ khởi tạo khung System Prompt / Agent Manual (`AGENTS.md`) và Operational Workspace (`process/`) theo chuẩn **RIPER-5 Framework** cho mọi repository hoặc subsystem.
 
----
+CLI sở hữu giao diện trực quan với phong cách **Tokyo Night Theme**, hỗ trợ hiển thị trạng thái chi tiết, thống kê quá trình cài đặt và hướng dẫn các bước tiếp theo.
 
-## 1. Khởi tạo từ xa (Remote Execution)
+---
 
-Không cần clone repository, chạy trực tiếp trên máy đích.
+## 1. Khởi tạo nhanh với NPX (Khuyên dùng)
 
-### Node.js (npx)
+Không cần cài đặt toàn cục hay clone repository, bạn có thể khởi tạo trực tiếp bất kỳ lúc nào:
 
 ```bash
 # Khởi tạo tại thư mục hiện tại
 npx @damphuquy/agent-init .
 
-# Khởi tạo vào thư mục chỉ định
+# Khởi tạo vào thư mục / subsystem chỉ định
 npx @damphuquy/agent-init ./my-project
-```
-
-### Linux / macOS / WSL (Bash)
-
-```bash
-# Khởi tạo tại thư mục hiện tại
-curl -fsSL https://raw.githubusercontent.com/<USER>/<REPO>/main/bootstrap.sh | bash
-
-# Khởi tạo vào thư mục chỉ định
-curl -fsSL https://raw.githubusercontent.com/<USER>/<REPO>/main/bootstrap.sh | bash -s -- ./my-project
-```
-
-### Windows (PowerShell)
-
-```powershell
-# Khởi tạo tại thư mục hiện tại
-irm https://raw.githubusercontent.com/<USER>/<REPO>/main/bootstrap.ps1 | iex
-
-# Khởi tạo vào thư mục chỉ định
-& ([scriptblock]::Create((irm https://raw.githubusercontent.com/<USER>/<REPO>/main/bootstrap.ps1))) -TargetDir ".\my-project"
+npx @damphuquy/agent-init ./services/billing
 ```
 
 ---
 
 ## 2. Khởi tạo cục bộ (Local Execution)
 
-Khi đã tải hoặc clone repository về máy:
+Khi làm việc trực tiếp trong repository mã nguồn:
 
 ```bash
-# Sử dụng Node.js
-node bin/bootstrap.js [target_directory]
+# Build mã nguồn TypeScript
+npm run build
 
-# Sử dụng Bash
-bash bootstrap.sh [target_directory]
+# Chạy trực tiếp qua CLI
+npm start -- [target_directory] [options]
 
-# Sử dụng Python
-python3 bootstrap.py [target_directory]
+# Hoặc qua npx/node
+node dist/cli.js [target_directory] [options]
+node bin/bootstrap.js [target_directory] [options]
 ```
 
 ---
 
 ## 3. Tùy chọn tham số (Options)
 
-- `-f, --force`: Ghi đè file nếu đã tồn tại trước đó.
-- `-h, --help`: Hiển thị hướng dẫn sử dụng.
+- `-f, --force`: Ghi đè các file đã tồn tại trước đó.
+- `-h, --help`: Hiển thị bảng trợ giúp và các ví dụ sử dụng.
+- `-v, --version`: Hiển thị phiên bản hiện tại.
 
 Ví dụ:
 ```bash
 npx @damphuquy/agent-init ./my-project --force
-bash bootstrap.sh ./my-project --force
 ```
 
 ---
 
-## 4. Cấu trúc thư mục mã nguồn và chỉnh sửa template
-
-Tất cả template mẫu được tách riêng biệt thành các file thực tế trong thư mục `templates/`:
+## 4. Cấu trúc mã nguồn Scaffolder (TypeScript)
 
 ```text
 .
-├── templates/                     # Toàn bộ nội dung template (chỉnh sửa trực tiếp tại đây)
-│   ├── AGENTS.md
-│   ├── .agents/name_rule.md
+├── src/                           # Mã nguồn TypeScript (đầy đủ Type definitions)
+│   ├── types.ts                   # Interfaces, Types cho Palette, Theme, FileGroups, Options, Stats
+│   ├── theme.ts                   # Tokyo Night Color Engine & ANSI formatters
+│   ├── config.ts                  # File classification catalog & package info
+│   ├── ui.ts                      # Box renderer, Banner & Help documentation UI
+│   ├── scaffolder.ts              # Core Scaffolding Engine
+│   ├── cli.ts                     # CLI argument parser & runner entrypoint
+│   └── index.ts                   # Public library exports
+├── templates/                     # Toàn bộ template gốc (chỉnh sửa trực tiếp tại đây)
+│   ├── AGENTS.md                  # Master Agent Manual (4 Pillars & RIPER-5 Loop)
+│   ├── .agents/name_rule.md       # Quy tắc đặt tên và interface
 │   └── process/
-│       ├── README.md
+│       ├── README.md              # Trung tâm điều hành task process
 │       ├── _seeds/                # Các seed templates (task, program, context)
-│       ├── context/               # Context routers
-│       └── development-protocols/ # Quy chuẩn lập trình & điều phối
+│       │   ├── _GUIDE.md
+│       │   ├── task-template.md.seed
+│       │   ├── program-template.md.seed
+│       │   └── context-group.md.seed
+│       ├── context/               # Context routers & Planning standards
+│       ├── development-protocols/ # Giao thức lập trình & điều phối
+│       ├── features/              # Thư mục active/backlog/completed cho features
+│       └── general-plans/         # Thư mục active/backlog/completed cho general plans
+├── dist/                          # Compiled JavaScript & Type Declaration files (.d.ts)
 ├── bin/
-│   └── bootstrap.js               # CLI runner đọc trực tiếp từ templates/
-├── scripts/
-│   └── build-bundle.js            # Trình biên dịch tự động templates/ vào bootstrap.sh/ps1/py
-├── bootstrap.sh                   # Bản standalone cho curl | bash
-├── bootstrap.ps1                  # Bản standalone cho PowerShell irm | iex
-├── bootstrap.py                   # Bản standalone cho Python
+│   └── bootstrap.js               # CLI runner forwarder
+├── tsconfig.json                  # TypeScript Compiler Configuration (Strict mode)
 └── package.json
 ```
 
-Khi bạn chỉnh sửa bất kỳ nội dung nào trong thư mục `templates/`, chỉ cần chạy lệnh sau để tự động đồng bộ sang tất cả các file thực thi đơn lẻ:
-
-```bash
-npm run build
-```
-
 ---
 
 ## 5. Cấu trúc thư mục được sinh ra trên dự án đích
@@ -138,9 +123,12 @@ npm run build
 ## 6. Các bước sau khi khởi tạo
 
 1. **Cập nhật lệnh kiểm thử trong `AGENTS.md`**:
-   Mở file `<target_dir>/AGENTS.md` và chỉnh sửa các lệnh kiểm thử tại phần `<validation_commands>` phù hợp với công nghệ của dự án (ví dụ: `npm test`, `pytest`, `go test ./...`).
+   Mở file `<target_dir>/AGENTS.md` và tùy chỉnh các lệnh kiểm thử tại phần `<validation_commands>` phù hợp với stack công nghệ của dự án (ví dụ: `npm test`, `pytest`, `cargo test`, `go test ./...`).
 
 2. **Tạo task đầu tiên từ template**:
    ```bash
    cp process/_seeds/task-template.md.seed process/general-plans/active/01-init_PLAN.md
    ```
+
+3. **Kích hoạt AI Coding Agent**:
+   Yêu cầu Agent đọc file `AGENTS.md` để nắm quy trình và bắt đầu thực hiện kế hoạch trong `process/general-plans/active/01-init_PLAN.md`.

package/bin/bootstrap.js

@@ -1,88 +1,3 @@
 #!/usr/bin/env node
 
-const fs = require('fs');
-const path = require('path');
-
-function parseArgs() {
-  const args = process.argv.slice(2);
-  let targetDir = '.';
-  let force = false;
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    if (arg === '--force' || arg === '-f') {
-      force = true;
-    } else if (arg === '--help' || arg === '-h') {
-      console.log(`
-Usage:
-  npx @damphuquy/agent-init [target_directory] [options]
-  node bin/bootstrap.js [target_directory] [options]
-
-Options:
-  -f, --force      Overwrite existing files if present
-  -h, --help       Display this help message
-
-Examples:
-  npx @damphuquy/agent-init .
-  npx @damphuquy/agent-init ./services/billing --force
-`);
-      process.exit(0);
-    } else if (!arg.startsWith('-')) {
-      targetDir = arg;
-    }
-  }
-
-  return { targetDir, force };
-}
-
-function copyDirectoryRecursive(srcDir, destDir, targetBase, force, stats = { created: 0, skipped: 0 }) {
-  if (!fs.existsSync(destDir)) {
-    fs.mkdirSync(destDir, { recursive: true });
-  }
-
-  const entries = fs.readdirSync(srcDir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    const srcPath = path.join(srcDir, entry.name);
-    const destPath = path.join(destDir, entry.name);
-
-    if (entry.isDirectory()) {
-      copyDirectoryRecursive(srcPath, destPath, targetBase, force, stats);
-    } else {
-      const relPath = path.relative(targetBase, destPath);
-      if (fs.existsSync(destPath) && !force) {
-        console.log(`  [SKIPPED] ${relPath} (already exists, use --force to overwrite)`);
-        stats.skipped++;
-      } else {
-        fs.copyFileSync(srcPath, destPath);
-        console.log(`  [CREATED] ${relPath}`);
-        stats.created++;
-      }
-    }
-  }
-
-  return stats;
-}
-
-function scaffold(targetDir, force) {
-  const templatesDir = path.resolve(__dirname, '../templates');
-
-  if (!fs.existsSync(templatesDir)) {
-    console.error(`Error: Templates directory not found at ${templatesDir}`);
-    process.exit(1);
-  }
-
-  const resolvedTarget = path.resolve(process.cwd(), targetDir);
-  console.log(`Scaffolding RIPER-5 Coding Agents Workspace into: ${resolvedTarget}`);
-
-  const stats = copyDirectoryRecursive(templatesDir, resolvedTarget, resolvedTarget, force);
-
-  console.log(`\nSetup complete: ${stats.created} created, ${stats.skipped} skipped.`);
-  console.log(`\nNext Steps:`);
-  console.log(`  1. Review and customize validation commands in: ${path.join(targetDir, 'AGENTS.md')}`);
-  console.log(`  2. Instantiate your first active task:`);
-  console.log(`     cp ${path.join(targetDir, 'process/_seeds/task-template.md.seed')} ${path.join(targetDir, 'process/general-plans/active/01-init_PLAN.md')}\n`);
-}
-
-const { targetDir, force } = parseArgs();
-scaffold(targetDir, force);
+import '../dist/cli.js';

package/dist/cli.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { CliOptions } from './types.js';
+export declare function parseArgs(argv?: readonly string[]): CliOptions;
+export declare function run(): void;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxC,wBAAgB,SAAS,CAAC,IAAI,GAAE,SAAS,MAAM,EAA0B,GAAG,UAAU,CAoBrF;AAED,wBAAgB,GAAG,IAAI,IAAI,CAsB1B"}

package/dist/cli.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+import process from 'node:process';
+import { getPackageInfo } from './config.js';
+import { scaffold } from './scaffolder.js';
+import { colors } from './theme.js';
+import { showHelp } from './ui.js';
+export function parseArgs(argv = process.argv.slice(2)) {
+    let targetDir = '.';
+    let force = false;
+    let help = false;
+    let version = false;
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === '--force' || arg === '-f') {
+            force = true;
+        }
+        else if (arg === '--help' || arg === '-h') {
+            help = true;
+        }
+        else if (arg === '--version' || arg === '-v') {
+            version = true;
+        }
+        else if (!arg.startsWith('-')) {
+            targetDir = arg;
+        }
+    }
+    return { targetDir, force, help, version };
+}
+export function run() {
+    const options = parseArgs();
+    const pkgInfo = getPackageInfo();
+    if (options.help) {
+        showHelp(pkgInfo, colors);
+        process.exit(0);
+    }
+    if (options.version) {
+        console.log(`${pkgInfo.name} v${pkgInfo.version}`);
+        process.exit(0);
+    }
+    const result = scaffold({
+        targetDir: options.targetDir,
+        force: options.force,
+    });
+    if (!result.success) {
+        process.exit(1);
+    }
+}
+run();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,MAAM,UAAU,SAAS,CAAC,IAAI,GAAsB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACvE,IAAI,SAAS,GAAG,GAAG,CAAC;IACpB,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACtC,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;aAAM,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC5C,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;aAAM,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC/C,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;aAAM,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,SAAS,GAAG,GAAG,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,GAAG;IACjB,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IAEjC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC;QACtB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,GAAG,EAAE,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,5 @@
+import { FileGroup, PackageInfo } from './types.js';
+export declare const FILE_GROUPS: readonly FileGroup[];
+export declare function getPackageRoot(): string;
+export declare function getPackageInfo(packageRootDir?: string): PackageInfo;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEpD,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EA4C3C,CAAC;AAEF,wBAAgB,cAAc,IAAI,MAAM,CASvC;AAED,wBAAgB,cAAc,CAAC,cAAc,GAAE,MAAyB,GAAG,WAAW,CAgBrF"}

package/dist/config.js

@@ -0,0 +1,79 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import process from 'node:process';
+import { fileURLToPath } from 'node:url';
+export const FILE_GROUPS = [
+    {
+        title: 'Core Agent Manual & Interface Directives',
+        files: [
+            { path: 'AGENTS.md', desc: 'Master Agent Manual (4 Pillars & RIPER-5 Loop)' },
+            { path: '.agents/name_rule.md', desc: 'Agent naming conventions & interface contracts' },
+        ],
+    },
+    {
+        title: 'Operational Workspace Control & Seeds (_seeds/)',
+        files: [
+            { path: 'process/README.md', desc: 'Operational Workspace Control Center' },
+            { path: 'process/_seeds/_GUIDE.md', desc: 'Seed archetypes usage & lifecycle guide' },
+            { path: 'process/_seeds/task-template.md.seed', desc: 'Task Spec & Plan blueprint (INVEST & AC)' },
+            { path: 'process/_seeds/program-template.md.seed', desc: 'Multi-phase umbrella epic blueprint' },
+            { path: 'process/_seeds/context-group.md.seed', desc: 'Domain knowledge & context router blueprint' },
+        ],
+    },
+    {
+        title: 'Context Routing & Planning Standards (context/)',
+        files: [
+            { path: 'process/context/all-context.md', desc: 'Root context & knowledge routing registry' },
+            { path: 'process/context/planning/all-planning.md', desc: 'INVEST criteria & vertical slicing standards' },
+        ],
+    },
+    {
+        title: 'Engineering Protocols & Harness (development-protocols/)',
+        files: [
+            { path: 'process/development-protocols/all-development-protocols.md', desc: 'Development protocols index router' },
+            { path: 'process/development-protocols/orchestration.md', desc: 'Subagent delegation & isolation rules' },
+            { path: 'process/development-protocols/implementation-standards.md', desc: 'Strict typing & domain purity standards' },
+        ],
+    },
+    {
+        title: 'Lifecycle Pipelines & Task Directories (process/)',
+        files: [
+            { path: 'process/features/active/.gitkeep', desc: 'Active feature task pipeline' },
+            { path: 'process/features/backlog/.gitkeep', desc: 'Feature backlog & note pipeline' },
+            { path: 'process/features/completed/.gitkeep', desc: 'Completed feature archive pipeline' },
+            { path: 'process/general-plans/active/.gitkeep', desc: 'Active general plans pipeline' },
+            { path: 'process/general-plans/backlog/.gitkeep', desc: 'General plans backlog pipeline' },
+            { path: 'process/general-plans/completed/.gitkeep', desc: 'Completed general plans archive' },
+        ],
+    },
+];
+export function getPackageRoot() {
+    try {
+        const currentFilePath = fileURLToPath(import.meta.url);
+        const currentDir = path.dirname(currentFilePath);
+        // When in src/ or dist/, root is one level up
+        return path.resolve(currentDir, '..');
+    }
+    catch {
+        return process.cwd();
+    }
+}
+export function getPackageInfo(packageRootDir = getPackageRoot()) {
+    try {
+        const pkgPath = path.resolve(packageRootDir, 'package.json');
+        if (fs.existsSync(pkgPath)) {
+            const content = fs.readFileSync(pkgPath, 'utf8');
+            const parsed = JSON.parse(content);
+            return {
+                name: parsed.name ?? '@damphuquy/agent-init',
+                version: parsed.version ?? '1.0.0',
+                description: parsed.description,
+            };
+        }
+    }
+    catch {
+        // fallback
+    }
+    return { name: '@damphuquy/agent-init', version: '1.0.0' };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './types.js';
+export * from './theme.js';
+export * from './config.js';
+export * from './ui.js';
+export * from './scaffolder.js';
+export { parseArgs } from './cli.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from './types.js';
+export * from './theme.js';
+export * from './config.js';
+export * from './ui.js';
+export * from './scaffolder.js';
+export { parseArgs } from './cli.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC"}

package/dist/scaffolder.d.ts

@@ -0,0 +1,3 @@
+import { ScaffoldOptions, ScaffoldResult } from './types.js';
+export declare function scaffold(options: ScaffoldOptions): ScaffoldResult;
+//# sourceMappingURL=scaffolder.d.ts.map

package/dist/scaffolder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffolder.d.ts","sourceRoot":"","sources":["../src/scaffolder.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAiB,MAAM,YAAY,CAAC;AAE5E,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CA4GjE"}

package/dist/scaffolder.js

@@ -0,0 +1,96 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import process from 'node:process';
+import { FILE_GROUPS, getPackageInfo, getPackageRoot } from './config.js';
+import { colors } from './theme.js';
+import { renderBanner, renderBox } from './ui.js';
+export function scaffold(options) {
+    const { targetDir, force, cwd = process.cwd(), templatesDir = path.resolve(getPackageRoot(), 'templates'), } = options;
+    const pkgInfo = getPackageInfo();
+    renderBanner(pkgInfo, colors);
+    if (!fs.existsSync(templatesDir)) {
+        console.error(`\n   ${colors.badgeError()} Templates directory not found at: ${colors.red(templatesDir)}\n`);
+        return {
+            success: false,
+            stats: { created: 0, skipped: 0, directories: 0 },
+            targetPath: path.resolve(cwd, targetDir),
+        };
+    }
+    const resolvedTarget = path.resolve(cwd, targetDir);
+    const displayTarget = targetDir === '.' ? cwd : resolvedTarget;
+    // Configuration Card
+    console.log(colors.purple(colors.bold('  CONFIGURATION')));
+    console.log(`    ${colors.dim('Target Directory :')} ${colors.cyan(colors.bold(displayTarget))}`);
+    console.log(`    ${colors.dim('Overwrite Mode   :')} ${force ? colors.red(colors.bold('Enabled (--force)')) : colors.green('Disabled (Preserve existing)')}`);
+    console.log();
+    // Execution Progress
+    console.log(colors.purple(colors.bold('  INITIALIZING WORKSPACE')));
+    console.log();
+    const stats = { created: 0, skipped: 0, dirs: new Set() };
+    for (const group of FILE_GROUPS) {
+        console.log(`  ${colors.teal(colors.bold(group.title))}`);
+        for (const item of group.files) {
+            const srcPath = path.join(templatesDir, item.path);
+            const destPath = path.join(resolvedTarget, item.path);
+            const destDir = path.dirname(destPath);
+            if (!fs.existsSync(destDir)) {
+                fs.mkdirSync(destDir, { recursive: true });
+                stats.dirs.add(destDir);
+            }
+            else {
+                stats.dirs.add(destDir);
+            }
+            const displayRelPath = item.path.replace(/\/\.gitkeep$/, '');
+            const desc = item.desc ? ` ${colors.comment(`— ${item.desc}`)}` : '';
+            if (!fs.existsSync(srcPath)) {
+                continue;
+            }
+            if (fs.existsSync(destPath) && !force) {
+                console.log(`    ${colors.badgeSkipped()}  ${colors.dim(displayRelPath)}${desc}`);
+                stats.skipped++;
+            }
+            else {
+                fs.copyFileSync(srcPath, destPath);
+                console.log(`    ${colors.badgeCreated()}  ${colors.fg(colors.bold(displayRelPath))}${desc}`);
+                stats.created++;
+            }
+        }
+        console.log();
+    }
+    // Summary Card
+    const summaryLines = [
+        `  ${colors.dim('Files Created     :')}  ${colors.green(colors.bold(String(stats.created)))}`,
+        `  ${colors.dim('Files Skipped     :')}  ${colors.yellow(colors.bold(String(stats.skipped)))}`,
+        `  ${colors.dim('Directories Setup :')}  ${colors.blue(colors.bold(String(stats.dirs.size)))}`,
+    ];
+    console.log(renderBox(summaryLines, colors, { title: colors.teal(colors.bold('SETUP SUMMARY')) }));
+    console.log();
+    // Next Steps Guide
+    const relPathPrefix = targetDir === '.' ? '.' : targetDir;
+    const agentsPath = path.join(relPathPrefix, 'AGENTS.md');
+    const seedTaskPath = path.join(relPathPrefix, 'process/_seeds/task-template.md.seed');
+    const activePlanPath = path.join(relPathPrefix, 'process/general-plans/active/01-init_PLAN.md');
+    const nextStepLines = [
+        `${colors.cyan(colors.bold('1. Configure Validation Commands:'))}`,
+        `   Edit ${colors.green(agentsPath)} and specify your project test/lint/typecheck commands.`,
+        '',
+        `${colors.cyan(colors.bold('2. Instantiate Your First Active Task:'))}`,
+        `   ${colors.yellow(`cp ${seedTaskPath} \\`)}`,
+        `      ${colors.yellow(activePlanPath)}`,
+        '',
+        `${colors.cyan(colors.bold('3. Activate AI Coding Agent:'))}`,
+        `   Direct your agent to read ${colors.green(agentsPath)} and begin execution.`,
+    ];
+    console.log(renderBox(nextStepLines, colors, { title: colors.purple(colors.bold('NEXT STEPS')) }));
+    console.log();
+    return {
+        success: true,
+        stats: {
+            created: stats.created,
+            skipped: stats.skipped,
+            directories: stats.dirs.size,
+        },
+        targetPath: resolvedTarget,
+    };
+}
+//# sourceMappingURL=scaffolder.js.map

package/dist/scaffolder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffolder.js","sourceRoot":"","sources":["../src/scaffolder.ts"],"names":[],"mappings":"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"}

package/dist/theme.d.ts

@@ -0,0 +1,8 @@
+import { TokyoNightPalette, ColorEngine, RGBTuple, ColorFunction } from './types.js';
+export declare const TN: TokyoNightPalette;
+export declare function isColorSupported(): boolean;
+export declare function createRgbFormatter(r: number, g: number, b: number, supported: boolean): ColorFunction;
+export declare function createBadgeFormatter(text: string, fgTuple: RGBTuple, bgTuple: RGBTuple, supported: boolean): () => string;
+export declare function createColorEngine(supported?: boolean): ColorEngine;
+export declare const colors: ColorEngine;
+//# sourceMappingURL=theme.d.ts.map

package/dist/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAErF,eAAO,MAAM,EAAE,EAAE,iBAgBhB,CAAC;AAEF,wBAAgB,gBAAgB,IAAI,OAAO,CAI1C;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,aAAa,CAErG;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,MAAM,CAOzH;AAED,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,OAA4B,GAAG,WAAW,CAoBtF;AAED,eAAO,MAAM,MAAM,aAAsB,CAAC"}

package/dist/theme.js

@@ -0,0 +1,60 @@
+import process from 'node:process';
+export const TN = {
+    bg_dark: [26, 27, 38], // #1a1b26 - Night Dark
+    bg_highlight: [41, 46, 66], // #292e42 - Selection Dark
+    border: [59, 66, 97], // #3b4261 - Slate Border
+    comment: [86, 95, 137], // #565f89 - Muted Gray
+    fg: [192, 202, 245], // #c0caf5 - Moonlight White/Blue
+    fg_dim: [169, 177, 214], // #a9b1d6 - Soft Foreground
+    blue: [122, 162, 247], // #7aa2f7 - Sky Blue (Primary)
+    cyan: [125, 207, 255], // #7dcfff - Bright Cyan
+    teal: [115, 218, 202], // #73daca - Fresh Teal
+    purple: [187, 154, 247], // #bb9af7 - Lavender Purple
+    green: [158, 206, 106], // #9ece6a - Olive Green (Success)
+    yellow: [224, 175, 104], // #e0af68 - Ochre Yellow (Warning)
+    orange: [255, 158, 100], // #ff9e64 - Coral Orange
+    red: [247, 118, 142], // #f7768e - Ruby Red (Error)
+    white: [255, 255, 255],
+};
+export function isColorSupported() {
+    if (process.env.NO_COLOR || process.argv.includes('--no-color'))
+        return false;
+    if (process.env.FORCE_COLOR)
+        return true;
+    return Boolean(process.stdout.isTTY);
+}
+export function createRgbFormatter(r, g, b, supported) {
+    return (text) => (supported ? `\x1b[38;2;${r};${g};${b}m${text}\x1b[0m` : String(text));
+}
+export function createBadgeFormatter(text, fgTuple, bgTuple, supported) {
+    return () => {
+        if (!supported)
+            return `[${text}]`;
+        const [fr, fg, fb] = fgTuple;
+        const [br, bg, bb] = bgTuple;
+        return `\x1b[38;2;${fr};${fg};${fb}m\x1b[48;2;${br};${bg};${bb}m\x1b[1m ${text} \x1b[0m`;
+    };
+}
+export function createColorEngine(supported = isColorSupported()) {
+    return {
+        blue: createRgbFormatter(...TN.blue, supported),
+        cyan: createRgbFormatter(...TN.cyan, supported),
+        teal: createRgbFormatter(...TN.teal, supported),
+        purple: createRgbFormatter(...TN.purple, supported),
+        green: createRgbFormatter(...TN.green, supported),
+        yellow: createRgbFormatter(...TN.yellow, supported),
+        orange: createRgbFormatter(...TN.orange, supported),
+        red: createRgbFormatter(...TN.red, supported),
+        fg: createRgbFormatter(...TN.fg, supported),
+        dim: createRgbFormatter(...TN.fg_dim, supported),
+        comment: createRgbFormatter(...TN.comment, supported),
+        border: createRgbFormatter(...TN.border, supported),
+        bold: (text) => (supported ? `\x1b[1m${text}\x1b[22m` : String(text)),
+        italic: (text) => (supported ? `\x1b[3m${text}\x1b[23m` : String(text)),
+        badgeCreated: createBadgeFormatter('CREATED', TN.bg_dark, TN.green, supported),
+        badgeSkipped: createBadgeFormatter('SKIPPED', TN.bg_dark, TN.yellow, supported),
+        badgeError: createBadgeFormatter(' ERROR ', TN.white, TN.red, supported),
+    };
+}
+export const colors = createColorEngine();
+//# sourceMappingURL=theme.js.map

package/dist/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,cAAc,CAAC;AAGnC,MAAM,CAAC,MAAM,EAAE,GAAsB;IACnC,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAS,uBAAuB;IACrD,YAAY,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAI,2BAA2B;IACzD,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAU,yBAAyB;IACvD,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,EAAQ,uBAAuB;IACrD,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAW,iCAAiC;IAC/D,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAO,4BAA4B;IAC1D,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAS,+BAA+B;IAC7D,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAS,wBAAwB;IACtD,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAS,uBAAuB;IACrD,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAO,4BAA4B;IAC1D,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAQ,kCAAkC;IAChE,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAO,mCAAmC;IACjE,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAO,yBAAyB;IACvD,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAU,6BAA6B;IAC3D,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;CACvB,CAAC;AAEF,MAAM,UAAU,gBAAgB;IAC9B,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,SAAkB;IACpF,OAAO,CAAC,IAAqB,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3G,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,OAAiB,EAAE,OAAiB,EAAE,SAAkB;IACzG,OAAO,GAAG,EAAE;QACV,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,IAAI,GAAG,CAAC;QACnC,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC;QAC7B,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC;QAC7B,OAAO,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,IAAI,UAAU,CAAC;IAC3F,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAAS,GAAY,gBAAgB,EAAE;IACvE,OAAO;QACL,IAAI,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC;QAC/C,IAAI,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC;QAC/C,IAAI,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC;QAC/C,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;QACnD,KAAK,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC;QACjD,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;QACnD,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;QACnD,GAAG,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,SAAS,CAAC;QAC7C,EAAE,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,SAAS,CAAC;QAC3C,GAAG,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;QAChD,OAAO,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;QACrD,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;QACnD,IAAI,EAAE,CAAC,IAAqB,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,IAAI,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACtF,MAAM,EAAE,CAAC,IAAqB,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,IAAI,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxF,YAAY,EAAE,oBAAoB,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC;QAC9E,YAAY,EAAE,oBAAoB,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;QAC/E,UAAU,EAAE,oBAAoB,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,SAAS,CAAC;KACzE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Type definitions for @damphuquy/agent-init scaffolding engine
+ */
+export type RGBTuple = readonly [r: number, g: number, b: number];
+export type ColorFunction = (text: string | number) => string;
+export type BadgeFunction = () => string;
+export interface TokyoNightPalette {
+    readonly bg_dark: RGBTuple;
+    readonly bg_highlight: RGBTuple;
+    readonly border: RGBTuple;
+    readonly comment: RGBTuple;
+    readonly fg: RGBTuple;
+    readonly fg_dim: RGBTuple;
+    readonly blue: RGBTuple;
+    readonly cyan: RGBTuple;
+    readonly teal: RGBTuple;
+    readonly purple: RGBTuple;
+    readonly green: RGBTuple;
+    readonly yellow: RGBTuple;
+    readonly orange: RGBTuple;
+    readonly red: RGBTuple;
+    readonly white: RGBTuple;
+}
+export interface ColorEngine {
+    readonly blue: ColorFunction;
+    readonly cyan: ColorFunction;
+    readonly teal: ColorFunction;
+    readonly purple: ColorFunction;
+    readonly green: ColorFunction;
+    readonly yellow: ColorFunction;
+    readonly orange: ColorFunction;
+    readonly red: ColorFunction;
+    readonly fg: ColorFunction;
+    readonly dim: ColorFunction;
+    readonly comment: ColorFunction;
+    readonly border: ColorFunction;
+    readonly bold: ColorFunction;
+    readonly italic: ColorFunction;
+    readonly badgeCreated: BadgeFunction;
+    readonly badgeSkipped: BadgeFunction;
+    readonly badgeError: BadgeFunction;
+}
+export interface BoxOptions {
+    readonly title?: string;
+    readonly borderColor?: ColorFunction;
+    readonly minWidth?: number;
+}
+export interface PackageInfo {
+    readonly name: string;
+    readonly version: string;
+    readonly description?: string;
+}
+export interface FileItem {
+    readonly path: string;
+    readonly desc?: string;
+}
+export interface FileGroup {
+    readonly title: string;
+    readonly files: readonly FileItem[];
+}
+export interface CliOptions {
+    readonly targetDir: string;
+    readonly force: boolean;
+    readonly help: boolean;
+    readonly version: boolean;
+}
+export interface ScaffoldStats {
+    created: number;
+    skipped: number;
+    dirs: Set<string>;
+}
+export interface ScaffoldOptions {
+    readonly targetDir: string;
+    readonly force: boolean;
+    readonly templatesDir?: string;
+    readonly cwd?: string;
+}
+export interface ScaffoldResult {
+    readonly success: boolean;
+    readonly stats: {
+        readonly created: number;
+        readonly skipped: number;
+        readonly directories: number;
+    };
+    readonly targetPath: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for @damphuquy/agent-init scaffolding engine
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/ui.d.ts

@@ -0,0 +1,8 @@
+import { BoxOptions, ColorEngine, PackageInfo } from './types.js';
+export declare function stripAnsi(str: string): string;
+export declare function visibleLength(str: string): number;
+export declare function padEndVisible(str: string, targetWidth: number): string;
+export declare function renderBox(lines: readonly string[], colors: ColorEngine, options?: BoxOptions): string;
+export declare function renderBanner(pkgInfo: PackageInfo, colors: ColorEngine): void;
+export declare function showHelp(pkgInfo: PackageInfo, colors: ColorEngine): void;
+//# sourceMappingURL=ui.d.ts.map

package/dist/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAElE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAItE;AAED,wBAAgB,SAAS,CACvB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,UAAe,GACvB,MAAM,CAwCR;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAS5E;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAwBxE"}

package/dist/ui.js

@@ -0,0 +1,86 @@
+export function stripAnsi(str) {
+    return String(str).replace(/\x1b\[[0-9;]*m/g, '');
+}
+export function visibleLength(str) {
+    return stripAnsi(str).length;
+}
+export function padEndVisible(str, targetWidth) {
+    const vLen = visibleLength(str);
+    if (vLen >= targetWidth)
+        return str;
+    return str + ' '.repeat(targetWidth - vLen);
+}
+export function renderBox(lines, colors, options = {}) {
+    const { title = '', borderColor = colors.border, minWidth = 76 } = options;
+    let maxContentLen = 0;
+    for (const item of lines) {
+        if (item !== '---' && item !== '') {
+            maxContentLen = Math.max(maxContentLen, visibleLength(item));
+        }
+    }
+    if (title) {
+        maxContentLen = Math.max(maxContentLen, visibleLength(title) + 4);
+    }
+    const width = Math.max(minWidth, maxContentLen + 4);
+    const contentWidth = width - 4;
+    const topBorder = '─'.repeat(width - 2);
+    const out = [];
+    if (title) {
+        const titleLen = visibleLength(title);
+        const rightDashes = '─'.repeat(Math.max(0, width - 5 - titleLen));
+        out.push(`  ${borderColor('╭─ ')}${title} ${borderColor(`${rightDashes}╮`)}`);
+    }
+    else {
+        out.push(`  ${borderColor(`╭${topBorder}╮`)}`);
+    }
+    for (const item of lines) {
+        if (item === '---') {
+            out.push(`  ${borderColor(`├${topBorder}┤`)}`);
+        }
+        else if (item === '') {
+            out.push(`  ${borderColor('│')}${' '.repeat(width - 2)}${borderColor('│')}`);
+        }
+        else {
+            const padded = padEndVisible(item, contentWidth);
+            out.push(`  ${borderColor('│')} ${padded} ${borderColor('│')}`);
+        }
+    }
+    out.push(`  ${borderColor(`╰${topBorder}╯`)}`);
+    return out.join('\n');
+}
+export function renderBanner(pkgInfo, colors) {
+    const bannerLines = [
+        colors.purple(colors.bold('RIPER-5 CODING AGENTS & OPERATIONAL WORKSPACE')),
+        colors.cyan('Deterministic Framework & Engineering Harness for AI Agents'),
+        colors.comment(`${pkgInfo.name} • v${pkgInfo.version} • Tokyo Night Theme`),
+    ];
+    console.log();
+    console.log(renderBox(bannerLines, colors));
+    console.log();
+}
+export function showHelp(pkgInfo, colors) {
+    renderBanner(pkgInfo, colors);
+    console.log(colors.purple(colors.bold('  USAGE')));
+    console.log(`    ${colors.cyan('$')} ${colors.green('npx @damphuquy/agent-init')} ${colors.dim('[target_directory]')} ${colors.yellow('[options]')}`);
+    console.log(`    ${colors.cyan('$')} ${colors.green('node dist/cli.js')} ${colors.dim('[target_directory]')} ${colors.yellow('[options]')}`);
+    console.log();
+    console.log(colors.purple(colors.bold('  ARGUMENTS')));
+    console.log(`    ${colors.cyan('target_directory')}  Destination path for workspace ${colors.comment('(default: .)')}`);
+    console.log();
+    console.log(colors.purple(colors.bold('  OPTIONS')));
+    console.log(`    ${colors.yellow('-f, --force')}       Overwrite existing files if already present`);
+    console.log(`    ${colors.yellow('-h, --help')}        Display this help documentation`);
+    console.log(`    ${colors.yellow('-v, --version')}     Display version number`);
+    console.log();
+    console.log(colors.purple(colors.bold('  EXAMPLES')));
+    console.log(`    ${colors.comment('# Scaffold into current directory:')}`);
+    console.log(`    ${colors.cyan('$')} npx @damphuquy/agent-init .`);
+    console.log();
+    console.log(`    ${colors.comment('# Scaffold into a specific project or subsystem:')}`);
+    console.log(`    ${colors.cyan('$')} npx @damphuquy/agent-init ./services/ai-agent`);
+    console.log();
+    console.log(`    ${colors.comment('# Force overwrite existing files:')}`);
+    console.log(`    ${colors.cyan('$')} npx @damphuquy/agent-init . --force`);
+    console.log();
+}
+//# sourceMappingURL=ui.js.map

package/dist/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,22 +1,29 @@
 {
   "name": "@damphuquy/agent-init",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Scaffolding CLI to bootstrap RIPER-5 Coding Agents & Operational Workspace",
-  "main": "bin/bootstrap.js",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "bin": {
-    "agent-init": "./bin/bootstrap.js"
+    "agent-init": "./bin/bootstrap.js",
+    "@damphuquy/agent-init": "./bin/bootstrap.js"
   },
   "files": [
-    "bin",
-    "templates"
+    "dist",
+    "templates",
+    "bin"
   ],
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build": "node scripts/build-bundle.js",
-    "start": "node ./bin/bootstrap.js",
-    "scaffold": "node ./bin/bootstrap.js"
+    "build": "tsc && chmod +x dist/cli.js",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "start": "node ./dist/cli.js",
+    "scaffold": "node ./dist/cli.js",
+    "test": "node ./dist/cli.js --help"
   },
   "keywords": [
     "ai-agent",
@@ -31,5 +38,9 @@
   "license": "MIT",
   "engines": {
     "node": ">=16.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.4.0",
+    "typescript": "^7.0.2"
   }
 }