@haaaiawd/anws 1.0.0

package/README.md

@@ -0,0 +1,96 @@
+# anws
+
+**Antigravity Workflow System** — 一条命令，将 AI 协作工作流体系注入任意项目。
+
+```
+npm install -g @haaaiawd/anws
+anws init
+```
+
+---
+
+## 安装
+
+```bash
+npm install -g @haaaiawd/anws
+```
+
+需要 **Node.js ≥ 18**。
+
+---
+
+## 命令
+
+### `anws init`
+
+将 `.agent/` 工作流体系复制到当前项目目录。
+
+```bash
+cd my-project
+anws init
+```
+
+- **首次初始化**：直接写入所有文件，不覆盖任何已有文件。
+- **检测到冲突**：显示已存在的托管文件数量，询问是否覆盖（默认 **N**）。  
+  确认后只会覆盖 `anws` 管理的文件，你的自定义文件不受影响。
+- **非 TTY 环境（如 CI）**：检测到冲突时自动跳过，不挂起进程。
+
+### `anws update`
+
+将当前项目的 `.agent/` 托管文件更新到最新版本。
+
+```bash
+anws update
+```
+
+- 仅覆盖 `anws` 管理的文件，用户自定义文件完全保留。
+- 交互式确认（默认 **N**），防止误操作。
+
+### 选项
+
+| 选项 | 说明 |
+|------|------|
+| `-v`, `--version` | 打印版本号 |
+| `-h`, `--help` | 显示帮助信息 |
+
+---
+
+## 无 npm 安装方式
+
+如果你不想全局安装，也可以直接克隆仓库手动获取模板：
+
+```bash
+# 克隆仓库
+git clone https://github.com/YOYZHANG/Antigravity-Workflow-System.git
+
+# 将 templates/.agent/ 复制到你的项目
+cp -r Antigravity-Workflow-System/src/anws/templates/.agent/ my-project/
+```
+
+---
+
+## 完成初始化后
+
+1. 阅读 `.agent/rules/agents.md` — 了解系统的核心法则
+2. 在你的 AI 助手中执行 `/genesis` — 启动新项目的架构设计流程
+
+---
+
+## 冲突处理机制
+
+`anws` 维护一份静态的**托管文件清单**（34 个文件），只有清单内的文件才会被覆盖，清单外的文件永远不会被修改。
+
+这意味着你可以安全地在 `.agent/` 目录中添加自定义工作流或技能，`anws update` 不会碰它们。
+
+---
+
+## 系统要求
+
+- Node.js **≥ 18.0.0**
+- 无运行时依赖
+
+---
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+'use strict';
+
+const { parseArgs } = require('node:util');
+const path = require('node:path');
+const { error, info, logo } = require('../lib/output');
+
+// ─── 版本号从 package.json 读取 ─────────────────────────────────────────────
+const { version } = require(path.join(__dirname, '..', 'package.json'));
+
+// ─── 帮助文本 ─────────────────────────────────────────────────────────────────
+const HELP = `
+  v${version} — Antigravity Workflow System
+
+USAGE
+  anws <command> [options]
+
+COMMANDS
+  init      Copy .agent/ workflow system into the current project
+  update    Update managed .agent/ files to the latest version
+
+OPTIONS
+  -v, --version   Print version number
+  -h, --help      Show this help message
+
+EXAMPLES
+  anws init          # Set up workflow system in current directory
+  anws update        # Update existing workflow files to latest
+`.trimStart();
+
+// ─── 参数解析 ─────────────────────────────────────────────────────────────────
+const { values, positionals } = parseArgs({
+  args: process.argv.slice(2),
+  options: {
+    version: { type: 'boolean', short: 'v', default: false },
+    help:    { type: 'boolean', short: 'h', default: false },
+  },
+  strict: false,
+  allowPositionals: true,
+});
+
+// ─── 命令路由 ─────────────────────────────────────────────────────────────────
+async function main() {
+  if (values.version) {
+    console.log(version);
+    process.exit(0);
+  }
+
+  if (values.help || positionals.length === 0) {
+    logo();
+    process.stdout.write(HELP);
+    process.exit(0);
+  }
+
+  const command = positionals[0];
+
+  switch (command) {
+    case 'init':
+      await require('../lib/init')();
+      break;
+
+    case 'update':
+      await require('../lib/update')();
+      break;
+
+    default:
+      error(`Unknown command: "${command}"`);
+      info('Run `anws --help` to see available commands.');
+      process.exit(1);
+  }
+}
+
+main().catch((err) => {
+  error(`Unexpected error: ${err.message}`);
+  process.exit(1);
+});

package/lib/copy.js

@@ -0,0 +1,38 @@
+'use strict';
+
+const fs = require('node:fs/promises');
+const path = require('node:path');
+
+/**
+ * 递归复制目录，返回已写入的文件路径数组（相对于 destDir）。
+ *
+ * @param {string} srcDir  源目录绝对路径
+ * @param {string} destDir 目标目录绝对路径（不存在时自动创建）
+ * @returns {Promise<string[]>} 已写入文件的绝对路径列表
+ */
+async function copyDir(srcDir, destDir) {
+  const written = [];
+
+  async function walk(src, dest) {
+    await fs.mkdir(dest, { recursive: true });
+    const entries = await fs.readdir(src, { withFileTypes: true });
+
+    for (const entry of entries) {
+      const srcPath = path.join(src, entry.name);
+      const destPath = path.join(dest, entry.name);
+
+      if (entry.isDirectory()) {
+        await walk(srcPath, destPath);
+      } else if (entry.isFile()) {
+        await fs.copyFile(srcPath, destPath);
+        written.push(destPath);
+      }
+      // 忽略 symlink 等特殊文件类型
+    }
+  }
+
+  await walk(srcDir, destDir);
+  return written;
+}
+
+module.exports = { copyDir };

package/lib/index.js

@@ -0,0 +1,8 @@
+'use strict';
+
+// anws 是 CLI 工具，此文件为 package main 入口占位
+// 使用方式见 README.md：npm install -g anws && anws init
+module.exports = {
+  init: require('./init'),
+  update: require('./update'),
+};

package/lib/init.js

@@ -0,0 +1,139 @@
+'use strict';
+
+const fs = require('node:fs/promises');
+const path = require('node:path');
+const { copyDir } = require('./copy');
+const { MANAGED_FILES } = require('./manifest');
+const { success, warn, info, fileLine, blank, logo } = require('./output');
+
+/**
+ * anws init — 将工作流系统写入当前项目
+ */
+async function init() {
+  const cwd = process.cwd();
+  const srcRoot = path.join(__dirname, '..', 'templates', '.agent');
+  const destRoot = path.join(cwd, '.agent');
+
+  // ── 冲突检测（T1.2.3 在此处插入冲突分支）──────────────────────────────────
+  const conflicting = await findConflicts(cwd);
+  if (conflicting.length > 0) {
+    const confirmed = await askOverwrite(conflicting.length);
+    if (!confirmed) {
+      blank();
+      info('Aborted. No files were changed.');
+      process.exit(0);
+    }
+    // 仅覆盖托管文件（用户自有文件不受影响）
+    await overwriteManaged(srcRoot, cwd);
+    printSummary(conflicting, cwd, 'updated');
+    return;
+  }
+  // ── 无冲突:直接复制 ─────────────────────────────────────────────────────────
+
+  logo();
+  info('Initializing Antigravity Workflow System...');
+  blank();
+
+  const written = await copyDir(srcRoot, destRoot);
+
+  // 打印文件列表
+  for (const absPath of written) {
+    const rel = path.relative(cwd, absPath).replace(/\\/g, '/');
+    fileLine(rel);
+  }
+
+  blank();
+  success(`Done! ${written.length} files written to .agent/`);
+  printNextSteps();
+}
+
+// ─── 辅助函数 ──────────────────────────────────────────────────────────────────
+
+/**
+ * 找出 cwd 中已存在的托管文件列表。
+ * @returns {Promise<string[]>} 已存在的托管文件相对路径数组
+ */
+async function findConflicts(cwd) {
+  const conflicts = [];
+  for (const rel of MANAGED_FILES) {
+    const abs = path.join(cwd, rel);
+    const exists = await fs.access(abs).then(() => true).catch(() => false);
+    if (exists) conflicts.push(rel);
+  }
+  return conflicts;
+}
+
+/**
+ * 交互式询问用户是否覆盖（默认 N）。
+ * 非 TTY 环境（如 CI）自动返回 false。
+ * @returns {Promise<boolean>}
+ */
+async function askOverwrite(count) {
+  // 非 TTY 环境：默认不覆盖，防止 CI 挂起
+  if (!process.stdin.isTTY) {
+    warn(`${count} managed file(s) already exist. Non-TTY: skipping overwrite.`);
+    return false;
+  }
+
+  const readline = require('node:readline');
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+  return new Promise((resolve) => {
+    rl.question(
+      `\n\u26a0  ${count} managed file(s) already exist. Overwrite? [y/N] `,
+      (answer) => {
+        rl.close();
+        resolve(answer.trim().toLowerCase() === 'y');
+      }
+    );
+  });
+}
+
+/**
+ * 仅覆盖 MANAGED_FILES 清单内的文件，用户自有文件不受影响。
+ */
+async function overwriteManaged(srcRoot, cwd) {
+  // srcRoot 是 templates/.agent/
+  const srcBase = path.dirname(srcRoot); // templates/
+  for (const rel of MANAGED_FILES) {
+    // rel 格式: '.agent/skills/...'
+    const srcPath = path.join(srcBase, rel);
+    const destPath = path.join(cwd, rel);
+
+    // 确保目标目录存在
+    await fs.mkdir(path.dirname(destPath), { recursive: true });
+
+    // 只复制 templates 中存在的文件（安全检查）
+    const srcExists = await fs.access(srcPath).then(() => true).catch(() => false);
+    if (srcExists) {
+      await fs.copyFile(srcPath, destPath);
+    }
+  }
+}
+
+/**
+ * 打印操作摘要（更新场景）。
+ */
+function printSummary(files, cwd, action) {
+  const verb = action === 'updated' ? 'Updating' : 'Writing';
+  blank();
+  info(`${verb} files...`);
+  blank();
+  for (const rel of files) {
+    fileLine(rel.replace(/\\/g, '/'));
+  }
+  blank();
+  success(`Done! ${files.length} file(s) ${action}.`);
+  if (action === 'updated') {
+    info('Managed files have been updated to the latest version.');
+  }
+}
+
+function printNextSteps() {
+  blank();
+  info('Next steps:');
+  info('  1. Read .agent/rules/agents.md to understand the system');
+  info('  2. Run /genesis in your AI assistant to start a new project');
+}
+
+module.exports = init;

package/lib/manifest.js

@@ -0,0 +1,53 @@
+'use strict';
+
+/**
+ * MANAGED_FILES — anws 托管文件清单
+ *
+ * 此数组列出 anws 包负责管理的所有文件路径（相对于目标项目根目录）。
+ *
+ * 冲突检测规则：
+ * - 仅当目标项目中存在此清单内的文件时，才触发覆盖确认
+ * - 清单之外的用户文件，在任何情况下均不会被触碰
+ *
+ * 维护规则（重要）：
+ * - 每次向 templates/.agent/ 新增文件时，必须同步更新此数组
+ * - 文件路径格式：'.agent/relative/path'（Unix 风格斜杠）
+ */
+const MANAGED_FILES = [
+  '.agent/rules/agents.md',
+  '.agent/skills/build-inspector/SKILL.md',
+  '.agent/skills/complexity-guard/references/anti_patterns.md',
+  '.agent/skills/complexity-guard/SKILL.md',
+  '.agent/skills/concept-modeler/prompts/GLOSSARY_PROMPT.md',
+  '.agent/skills/concept-modeler/references/ENTITY_EXTRACTION_PROMPT.md',
+  '.agent/skills/concept-modeler/scripts/glossary_gen.py',
+  '.agent/skills/concept-modeler/SKILL.md',
+  '.agent/skills/git-forensics/references/ANALYSIS_METHODOLOGY.md',
+  '.agent/skills/git-forensics/scripts/git_forensics.py',
+  '.agent/skills/git-forensics/scripts/git_hotspots.py',
+  '.agent/skills/git-forensics/SKILL.md',
+  '.agent/skills/report-template/references/REPORT_TEMPLATE.md',
+  '.agent/skills/report-template/SKILL.md',
+  '.agent/skills/runtime-inspector/SKILL.md',
+  '.agent/skills/spec-writer/references/prd_template.md',
+  '.agent/skills/spec-writer/SKILL.md',
+  '.agent/skills/system-architect/references/rfc_template.md',
+  '.agent/skills/system-architect/SKILL.md',
+  '.agent/skills/system-designer/references/system-design-template.md',
+  '.agent/skills/system-designer/SKILL.md',
+  '.agent/skills/task-planner/references/TASK_TEMPLATE.md',
+  '.agent/skills/task-planner/SKILL.md',
+  '.agent/skills/tech-evaluator/references/ADR_TEMPLATE.md',
+  '.agent/skills/tech-evaluator/SKILL.md',
+  '.agent/workflows/blueprint.md',
+  '.agent/workflows/challenge.md',
+  '.agent/workflows/change.md',
+  '.agent/workflows/craft.md',
+  '.agent/workflows/design-system.md',
+  '.agent/workflows/explore.md',
+  '.agent/workflows/forge.md',
+  '.agent/workflows/genesis.md',
+  '.agent/workflows/scout.md',
+];
+
+module.exports = { MANAGED_FILES };

package/lib/output.js

@@ -0,0 +1,74 @@
+'use strict';
+
+/**
+ * lib/output.js — 统一终端输出工具
+ *
+ * 特性:
+ * - ✔ / ⚠ / ✖ Unicode 前缀区分成功/警告/错误
+ * - 自动 ANSI 颜色（TTY 环境）
+ * - 非 TTY 或 NO_COLOR=1 时自动降级为无颜色输出
+ * - 不依赖任何第三方库
+ */
+
+// ─── 颜色检测 ─────────────────────────────────────────────────────────────────
+const useColor =
+  !!process.stdout.isTTY &&
+  !process.env.NO_COLOR &&
+  process.env.TERM !== 'dumb';
+
+// ─── ANSI 转义码 ──────────────────────────────────────────────────────────────
+const c = {
+  green:  useColor ? '\x1b[32m' : '',
+  yellow: useColor ? '\x1b[33m' : '',
+  red:    useColor ? '\x1b[31m' : '',
+  dim:    useColor ? '\x1b[2m'  : '',
+  reset:  useColor ? '\x1b[0m'  : '',
+};
+
+// ─── 公共输出函数 ─────────────────────────────────────────────────────────────
+
+/** 成功消息（绿色 ✔）*/
+function success(msg) {
+  console.log(`${c.green}\u2714${c.reset} ${msg}`);
+}
+
+/** 警告/提示消息（黄色 ⚠）*/
+function warn(msg) {
+  console.log(`${c.yellow}\u26a0${c.reset}  ${msg}`);
+}
+
+/** 错误消息（红色 ✖，写入 stderr）*/
+function error(msg) {
+  console.error(`${c.red}\u2716${c.reset} ${msg}`);
+}
+
+/** 普通信息行（缩进两格）*/
+function info(msg) {
+  console.log(`  ${msg}`);
+}
+
+/** 文件路径行（dimmed 样式）*/
+function fileLine(relativePath) {
+  console.log(`  ${c.dim}${relativePath}${c.reset}`);
+}
+
+/** 空行 */
+function blank() {
+  console.log('');
+}
+
+/** 打印 ASCII Logo */
+function logo() {
+  const art = `
+    ___    _   ___      _______
+   /   |  / | / / | /| / / ___/
+  / /| | /  |/ /| |/ |/ /\\__ \\ 
+ / ___ |/ /|  / |  /|  /___/ / 
+/_/  |_/_/ |_/  |__/|__//____/ 
+  `;
+  const cyan = useColor ? '\x1b[36m' : '';
+  const reset = useColor ? '\x1b[0m' : '';
+  console.log(`${cyan}${art}${reset}`);
+}
+
+module.exports = { success, warn, error, info, fileLine, blank, logo, c };

package/lib/update.js

@@ -0,0 +1,85 @@
+'use strict';
+
+const fs = require('node:fs/promises');
+const path = require('node:path');
+const { MANAGED_FILES } = require('./manifest');
+const { success, warn, error, info, fileLine, blank, logo } = require('./output');
+
+/**
+ * anws update — 将当前项目的托管文件更新到最新版本
+ */
+async function update() {
+  const cwd = process.cwd();
+  const agentDir = path.join(cwd, '.agent');
+
+  // 检查 .agent/ 是否存在
+  const agentExists = await fs.access(agentDir).then(() => true).catch(() => false);
+  if (!agentExists) {
+    logo();
+    error('No .agent/ found in current directory.');
+    info('Run `anws init` first to set up the workflow system.');
+    process.exit(1);
+  }
+
+  // 询问确认
+  const confirmed = await askUpdate();
+  if (!confirmed) {
+    blank();
+    info('Aborted. No files were changed.');
+    process.exit(0);
+  }
+
+  logo();
+  // 仅覆盖托管文件
+  const srcRoot = path.join(__dirname, '..', 'templates', '.agent');
+  const updated = [];
+
+  for (const rel of MANAGED_FILES) {
+    const srcPath = path.join(path.dirname(srcRoot), rel); // templates/.agent/...
+    const destPath = path.join(cwd, rel);
+
+    const srcExists = await fs.access(srcPath).then(() => true).catch(() => false);
+    if (!srcExists) continue;
+
+    await fs.mkdir(path.dirname(destPath), { recursive: true });
+    await fs.copyFile(srcPath, destPath);
+    updated.push(rel);
+  }
+
+  // 打印摘要
+  blank();
+  info('Updated files:');
+  blank();
+  for (const rel of updated) {
+    fileLine(rel.replace(/\\/g, '/'));
+  }
+  blank();
+  success(`Done! ${updated.length} file(s) updated.`);
+  info('Managed files have been updated to the latest version.');
+  info('Your custom files in .agent/ were not touched.');
+}
+
+/**
+ * 交互式确认更新操作（默认 N）。
+ */
+async function askUpdate() {
+  if (!process.stdin.isTTY) {
+    warn('Non-TTY environment detected. Skipping update to avoid accidental overwrites.');
+    return false;
+  }
+
+  const readline = require('node:readline');
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+  return new Promise((resolve) => {
+    rl.question(
+      '\n\u26a0 This will overwrite all managed .agent/ files. Continue? [y/N] ',
+      (answer) => {
+        rl.close();
+        resolve(answer.trim().toLowerCase() === 'y');
+      }
+    );
+  });
+}
+
+module.exports = update;

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@haaaiawd/anws",
+  "version": "1.0.0",
+  "description": "Antigravity Workflow System CLI — one command to install AI collaboration workflows into your project",
+  "keywords": [
+    "ai",
+    "workflow",
+    "agent",
+    "cli",
+    "developer-tools"
+  ],
+  "homepage": "https://github.com/your-org/antigravity-workflow-system",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/your-org/antigravity-workflow-system.git"
+  },
+  "author": "haaaiawd <1134180104@qq.com>",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "bin": {
+    "anws": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "templates/",
+    "README.md"
+  ],
+  "main": "./lib/index.js",
+  "scripts": {
+    "test": "node --test test/**/*.test.js"
+  },
+  "dependencies": {}
+}