@ecc-hgy/ae 0.2.0

package/src/utils/paths.js

@@ -0,0 +1,60 @@
+import { existsSync } from 'node:fs';
+import { access } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+let cachedPackageRoot;
+
+export async function packageRootAsync() {
+  if (cachedPackageRoot) {
+    return cachedPackageRoot;
+  }
+
+  let current = path.dirname(fileURLToPath(import.meta.url));
+  while (true) {
+    const candidate = path.join(current, 'package.json');
+    try {
+      await access(candidate);
+      cachedPackageRoot = current;
+      return cachedPackageRoot;
+    } catch {
+      const parent = path.dirname(current);
+      if (parent === current) {
+        throw new Error('Could not find package.json from current module path.');
+      }
+      current = parent;
+    }
+  }
+}
+
+export function packageRoot() {
+  if (cachedPackageRoot) {
+    return cachedPackageRoot;
+  }
+
+  let current = path.dirname(fileURLToPath(import.meta.url));
+  while (true) {
+    if (existsSync(path.join(current, 'package.json'))) {
+      cachedPackageRoot = current;
+      return cachedPackageRoot;
+    }
+
+    const parent = path.dirname(current);
+    if (parent === current) {
+      throw new Error('Could not find package.json from current module path.');
+    }
+    current = parent;
+  }
+}
+
+export function assetPath(name) {
+  return path.join(packageRoot(), name);
+}
+
+export function skillsPath() {
+  return path.join(packageRoot(), 'skills');
+}
+
+export function templatesPath(subdir = '') {
+  return path.join(packageRoot(), 'templates', subdir);
+}

package/src/utils/report.js

@@ -0,0 +1,31 @@
+export function formatSetupReport({ created, skipped, target, dryRun }) {
+  const installedLabel = dryRun ? 'Would install' : 'Installed';
+  return [
+    dryRun ? 'AE setup dry run complete' : 'AE setup complete',
+    `- ${installedLabel}: ${created.length} (${summarize(created)})`,
+    `- Skipped: ${skipped.length} (${summarize(skipped)})`,
+    `- Target: ${target}`,
+    `- Next: edit config/ae-rules.md (optional), then run \`ae init "<goal>"\`.`,
+  ].join('\n');
+}
+
+export function formatInitReport({ created, skipped, target, rules, dryRun }) {
+  const createdLabel = dryRun ? 'Would create' : 'Created';
+  return [
+    dryRun ? 'AE init dry run complete' : 'AE init complete',
+    `- ${createdLabel}: ${created.length} (${summarize(created)})`,
+    `- Skipped: ${skipped.length} (${summarize(skipped)})`,
+    `- Rules: ${rules}`,
+    `- Target: ${target}`,
+  ].join('\n');
+}
+
+function summarize(paths) {
+  if (paths.length === 0) {
+    return 'none';
+  }
+  if (paths.length <= 8) {
+    return paths.join(', ');
+  }
+  return `${paths.slice(0, 8).join(', ')}, ...`;
+}

package/templates/ae-rules.md

@@ -0,0 +1,17 @@
+# Project-Specific Rules
+
+<!-- 这个文件在 `ae init` 时会被读取,内容会注入到 AGENTS.md 与 CLAUDE.md 的
+     AE:RULES block 中。可以在 `ae setup` 之后、`ae init` 之前编辑。 -->
+
+## 通用约束
+
+- 例如:所有代码注释使用中文
+- 例如:提交信息遵循 Conventional Commits
+
+## 项目栈
+
+- 例如:Node.js 18+,TypeScript strict mode
+
+## 协作偏好
+
+- 例如:小步提交,每个 commit 必须包含测试

package/templates/entries/AGENTS.md

@@ -0,0 +1,21 @@
+# Project Goal
+
+{{PROJECT_GOAL}}
+
+## R1 Progressive Loading
+
+Keep this file short because every agent session loads it. Do trivial work directly. For non-trivial product, architecture, implementation, or debug work, first load the relevant local guidance or skill, then proceed.
+
+## Spec Landing Rules
+
+- SDD owns what to build; TDD owns how to prove it works.
+- After writing or changing anything under `spec/needs/<need-name>/`, update `spec/INDEX.md`.
+- If `spec/INDEX.md` cannot be updated confidently, run the future `index-rebuild` command or leave an explicit handoff note.
+- Do not write `prd.md` before requirement alignment.
+- Do not fix a bug before expected behavior is aligned.
+
+## Project Specific Rules
+
+<!-- AE:PROJECT:BEGIN -->
+<!-- Add project-specific rules here. `ae init` manages AE:RULES separately. -->
+<!-- AE:PROJECT:END -->

package/templates/entries/CLAUDE.md

@@ -0,0 +1,21 @@
+# Project Goal
+
+{{PROJECT_GOAL}}
+
+## R1 Progressive Loading
+
+Keep this file short because every agent session loads it. Do trivial work directly. For non-trivial product, architecture, implementation, or debug work, first load the relevant local guidance or skill, then proceed.
+
+## Spec Landing Rules
+
+- SDD owns what to build; TDD owns how to prove it works.
+- After writing or changing anything under `spec/needs/<need-name>/`, update `spec/INDEX.md`.
+- If `spec/INDEX.md` cannot be updated confidently, run the future `index-rebuild` command or leave an explicit handoff note.
+- Do not write `prd.md` before requirement alignment.
+- Do not fix a bug before expected behavior is aligned.
+
+## Project Specific Rules
+
+<!-- AE:PROJECT:BEGIN -->
+<!-- Add project-specific rules here. `ae init` manages AE:RULES separately. -->
+<!-- AE:PROJECT:END -->

package/templates/entries/README.md

@@ -0,0 +1,18 @@
+# {{PROJECT_NAME}}
+
+{{PROJECT_GOAL}}
+
+## Setup
+
+TODO: 记录安装和启动方式。
+
+## Usage
+
+TODO: 记录常用操作。
+
+## Project Map
+
+- `reference/`: 原始素材，只读心态。
+- `spec/`: SDD/TDD 规格产物。
+- `data/`: 运行产物、导出和缓存。
+- `scripts/`: 辅助脚本。

package/templates/entries/handoff.md

@@ -0,0 +1 @@
+<!-- 跨会话/跨项目进展交接，由 handoff skill 在会话结束时人工触发更新。 -->

package/templates/entries/spec/INDEX.md

@@ -0,0 +1,15 @@
+# spec 索引
+
+## 需求
+
+| 需求名 | prd | design | todo | issues | 当前节点 |
+|--------|-----|--------|------|--------|----------|
+
+## ADR
+
+| 编号 | 标题 | 状态 | 日期 |
+|------|------|------|------|
+
+## 跨需求引用
+
+- 暂无

package/templates/entries/spec/README.md

@@ -0,0 +1,19 @@
+# Spec Map
+
+## Needs
+
+```text
+TODO: 用 ASCII 图画出需求地图。
+```
+
+## Main Flow
+
+```text
+TODO: 用 ASCII 图画出核心业务流程。
+```
+
+## Relationships
+
+```text
+TODO: 按需记录需求间依赖或触发关系。
+```