@scemoon/cdh 1.0.9 → 1.0.10-beta.1

package/package.json

@@ -1,8 +1,15 @@
 {
   "name": "@scemoon/cdh",
-  "version": "1.0.9",
+  "version": "1.0.10-beta.1",
   "description": "Cloud Dev Harness - cloud-native development Agent framework",
-  "keywords": ["ai", "agent", "cloud", "development", "cli", "tui"],
+  "keywords": [
+    "ai",
+    "agent",
+    "cloud",
+    "development",
+    "cli",
+    "cdc"
+  ],
   "license": "MIT",
   "repository": {
     "type": "git",

package/ai-dlc-skill/SKILL.md

@@ -1,106 +0,0 @@
----
-name: ai-dlc-skill
-description: |
-  AI-Driven Development Lifecycle for monorepo multi-component stacks.
-  Core phases: Understand (SDD+BDD), Plan (SDD+TDD), Verify (BDD+TDD),
-  Deliver (SDD+Cloud). Adaptive orchestration: Master Agent evaluates
-  complexity, delegates sub-tasks.
-triggers:
-  - ai-dlc
-  - lifecycle
-  - BDD
-  - INT-FR
-  - spec-delta
-  - EARS
-  - feature-file
-  - task-list
-  - deploy-stack
-  - brownfield
-  - explore
-  - debug
-  - tcb-debug
-  - tcb-logs
-  - 排查日志
-allowed_tools:
-  - Read
-  - Write
-  - Edit
-  - Bash
-  - Grep
-  - Glob
-  - TodoClear
-  - TodoWrite
-  - Task
-  - AskUser
-phases:
-  - understand
-  - plan
-  - verify
-  - deliver
-  - brownfield
-  - debug
-compatibility:
-  cdh: ">=1.4"
-  opencode: ">=1.15"
-  claude-code: ">=1.0"
-  openai-codex: ">=1.0"
-  cursor: ">=0.45"
-license: Apache-2.0
-metadata:
-  version: "4.0.0"
-  stack_topology: monorepo
-  fr_namespaces: [NATIVE, DESKTOP, WEB, BE, WXA, MYA, TTA, INT]
----
-
-# AI-DLC Master Orchestrator
-
-## Core Cycle
-
-```
-0 Brownfield (optional)  Explore existing codebase → Context summary
-① Understand (SDD+BDD)   Intent → Spec Delta → BDD Feature Files
-② Plan (SDD+TDD)         Design Doc → Task DAG → Test Plan
-③ Verify (BDD+TDD)       Red → Green → Refactor per scenario
-④ Deliver (SDD+Cloud)    Stack Preview → e2e → Production + BVT
-⑤ Debug (optional)       TCB/云函数日志排查 → 问题定位
-```
-
-## Components
-
-| Prefix | Component | Directory | FR Namespace |
-|--------|-----------|-----------|--------------|
-| NATIVE | Mobile | `apps/native/` | `NATIVE-FR-NNN` |
-| DESKTOP | Desktop | `apps/desktop/` | `DESKTOP-FR-NNN` |
-| WEB | Browser | `apps/web/` | `WEB-FR-NNN` |
-| BE | Service | `apps/backend/` | `BE-FR-NNN` |
-| WXA | WeChat Mini | `apps/wxa/` | `WXA-FR-NNN` |
-| MYA | Alipay Mini | `apps/mya/` | `MYA-FR-NNN` |
-| TTA | TikTok Mini | `apps/tta/` | `TTA-FR-NNN` |
-| INT | Contracts | `aidlc/contracts/`, `aidlc/packages/shared/` | `INT-FR-NNN` |
-
-## Adaptive Flow
-
-See `core/adaptive-flow.md` for complexity assessment (L1-L5).
-See `core/task-registry.md` for task status tracking.
-See `core/security.md` for security baseline (SEC-001~007).
-
-**State file**: `.cdh/state.json`
-
-## Phase Reference
-
-| Phase | Entry | Lifecycle | Rules | Practices |
-|-------|-------|-----------|-------|-----------|
-| 0 Brownfield | `brownfield/entry.md` | `brownfield/README.md` | — | Explore existing codebase |
-| ① Understand | `phases/understand/entry.md` | `phases/understand/lifecycle.md` | `phases/understand/rules.md` | SDD, BDD |
-| ② Plan | `phases/plan/entry.md` | `phases/plan/lifecycle.md` | `phases/plan/rules.md` | SDD, TDD |
-| ③ Verify | `phases/verify/entry.md` | `phases/verify/lifecycle.md` | `phases/verify/rules.md` | BDD, TDD |
-| ④ Deliver | `phases/deliver/entry.md` | `phases/deliver/lifecycle.md` | `phases/deliver/rules.md` | SDD, Cloud |
-| ⑤ Debug | `phases/debug/entry.md` | `phases/debug/lifecycle.md` | — | TCB/云函数日志排查 |
-
-## Sub-agent Delegation
-
-Each phase is delegated via `Task(agent_type="ai-dlc-{phase}")` with the phase's `entry.md` as entry point.
-
-## Key Paths
-
-See `aidlc/CONFIG.md` for full path variable definitions.

package/ai-dlc-skill/architecture/project-structure.md

@@ -1,78 +0,0 @@
-# 项目工程目录架构
-
-## 顶层布局
-
-```
-{{project_root}}/
-├── apps/
-│   ├── native/          # NATIVE-FR-*   Mobile (Flutter/Dart)
-│   ├── desktop/         # DESKTOP-FR-*  Desktop (Electron/TypeScript)
-│   ├── web/             # WEB-FR-*      Browser (Next.js/TypeScript)
-│   ├── backend/         # BE-FR-*       Service (Python / Node / Go)
-│   ├── wxa/             # WXA-FR-*      WeChat Mini Program (Vant Weapp/JavaScript)
-│   ├── mya/             # MYA-FR-*      Alipay Mini Program (Ant Design Mini/JavaScript)
-│   └── tta/             # TTA-FR-*      TikTok Mini Program (TypeScript)
-├── aidlc/contracts/           # INT-FR-*      OpenAPI / AsyncAPI / Runtime Contract
-│   ├── api/
-│   ├── events/
-│   └── functions/
-├── aidlc/packages/shared/     # INT-FR-*      从 contracts 生成的共享类型
-├── aidlc/features/            # BDD feature 文件
-│   └── cross-stack/     # 跨组件集成场景
-├── aidlc/tests/
-│   ├── contract/        # 合约测试 (INT-FR 级别, provider-agnostic)
-│   └── cross-stack/     # 跨组件 e2e 测试 (对 STACK_URL 运行)
-├── aidlc/openspec/            # AI-DLC 生命周期产出物
-│   └── changes/{id}/
-│       ├── spec-delta.md
-│       ├── design.md
-│       ├── task-list.md
-│       ├── contract-diff.md
-│       └── walkthrough.md
-├── aidlc/providers/           # 云平台部署配置
-│   ├── tcb/
-│   └── aliyun/
-├── aidlc/tools/               # 脚手架脚本
-│   ├── generate_shared.py
-│   └── contract_diff.py
-├── .opencode/           # OpenCode 配置
-│   └── skills/ai-dlc-skill/
-├── .cdh/                # CDHA 项目状态
-│   ├── config.yaml
-│   ├── state.json
-│   └── SKILL.md
-└── aidlc/AI-DLC-CONTEXT.md    # Brownfield 上下文摘要 (自动生成)
-```
-
-## 组件内部结构 (标准模板)
-
-```
-apps/{component}/
-├── src/              # 实现代码
-│   └── {module}/
-├── tests/
-│   ├── unit/         # TDD 单元测试
-│   ├── integration/  # 集成测试 (含 DB)
-│   └── e2e/          # E2E 测试 (对 preview URL)
-├── features/         # BDD feature 文件
-│   └── steps/        # BDD step definitions
-├── contracts/        # 组件级合约引用
-├── .skill/           # 组件级 Skill (自动生成)
-│   └── SKILL.md
-├── package.json
-└── ...
-```
-
-## FR 命名空间 ↔ 目录映射
-
-| FR 前缀 | 目录 | 测试目录 | e2e target |
-|---------|------|---------|------------|
-| NATIVE-FR-NNN | `apps/native/src/` | `apps/native/tests/` | BACKEND_URL |
-| DESKTOP-FR-NNN | `apps/desktop/src/` | `apps/desktop/tests/` | BACKEND_URL |
-| WEB-FR-NNN | `apps/web/src/` | `apps/web/tests/` | WEB_URL + BACKEND_URL |
-| BE-FR-NNN | `apps/backend/src/` | `apps/backend/tests/` | BACKEND_URL |
-| WXA-FR-NNN | `apps/wxa/` | `apps/wxa/tests/` | BACKEND_URL |
-| MYA-FR-NNN | `apps/mya/` | `apps/mya/tests/` | BACKEND_URL |
-| TTA-FR-NNN | `apps/tta/` | `apps/tta/tests/` | BACKEND_URL |
-| INT-FR-NNN | `aidlc/contracts/` + `aidlc/packages/shared/` | `aidlc/tests/contract/` | generated types |
-| 跨组件 | `aidlc/features/cross-stack/` | `aidlc/tests/cross-stack/` | STACK_URL |

package/ai-dlc-skill/brownfield/README.md

@@ -1,36 +0,0 @@
-# Brownfield 存量项目支持
-
-为已有项目自动生成语义上下文，辅助 AI Agent 理解代码库。
-
-## 使用方式
-
-```bash
-# 一键生成 aidlc/AI-DLC-CONTEXT.md
-./brownfield/generate-context.sh
-
-# 单独步骤
-./brownfield/scripts/discover.sh       # 组件发现
-./brownfield/scripts/extract-api.sh    # API 表面提取
-./brownfield/scripts/deps.sh           # 跨组件依赖图
-```
-
-## 产出
-
-`aidlc/AI-DLC-CONTEXT.md` 文件包含：
-1. 发现的组件列表 + 技术栈
-2. API 端点摘要
-3. 跨组件依赖 Mermaid 图
-4. 架构速览
-
-模板文件位于 `templates/brownfield/context.md`（用于参考格式）。
-
-## 在 Phase 中的应用
-
-Brownfield 是可选的第 0 阶段，在以下情况触发：
-- L2+ 复杂度且有存量代码
-- Master Agent 自动调用 `Task(agent_type="explore", prompt="...brownfield/scripts/...")`
-
-Brownfield Phase 输出用于：
-1. 确认 `affects` 声明的准确性
-2. 发现潜在的跨组件依赖
-3. 为后续 Phase 提供上下文

package/ai-dlc-skill/brownfield/entry.md

@@ -1,45 +0,0 @@
----
-name: ai-dlc-brownfield
-description: "Brownfield Phase: Explore existing codebase → Generate AI-DLC Context"
-entry_point: brownfield/entry.md
-triggers:
-  - brownfield
-  - explore
-  - context
----
-
-# Brownfield Phase (存量探索)
-
-为已有项目自动生成语义上下文，辅助 AI Agent 理解代码库。
-
-## Lifecycle
-
-Brownfield 是可选的第 0 阶段，在 L2+ 复杂度且有存量代码时触发。
-
-## 当被委派时
-
-1. 运行 `brownfield/scripts/discover.sh` 发现组件
-2. 运行 `brownfield/scripts/extract-api.sh` 提取 API 表面
-3. 运行 `brownfield/scripts/deps.sh` 生成跨组件依赖图
-4. 运行 `brownfield/generate-context.sh` 生成 `aidlc/AI-DLC-CONTEXT.md`
-
-## 产出
-
-- `aidlc/AI-DLC-CONTEXT.md` — 包含：
-  - 组件列表 + 技术栈
-  - API 端点摘要
-  - 跨组件依赖 Mermaid 图
-  - 架构速览
-
-## 在 AI-DLC 流程中的应用
-
-Brownfield Phase 输出用于：
-1. 确认 `affects` 声明的准确性
-2. 发现潜在的跨组件依赖
-3. 为后续 Phase 提供上下文
-
-## 约束
-
-- 使用 `explore` agent type 进行代码探索
-- 不修改任何现有代码
-- 专注于生成准确的上下文摘要

package/ai-dlc-skill/brownfield/generate-context.sh

@@ -1,64 +0,0 @@
-#!/usr/bin/env bash
-# generate-context.sh — Generate AI-DLC-CONTEXT.md for brownfield projects
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-OUTPUT="$PROJECT_ROOT/aidlc/AI-DLC-CONTEXT.md"
-
-echo "# AI-DLC Context — $(basename "$PROJECT_ROOT")"
-echo ""
-echo "Auto-generated on $(date -u +%Y-%m-%dT%H:%M:%SZ)"
-echo ""
-
-# 1. Component discovery
-echo "## Components"
-echo ""
-for comp_dir in "$PROJECT_ROOT"/apps/*/; do
-  name="$(basename "$comp_dir")"
-  pkg="$comp_dir/package.json"
-  if [ -f "$pkg" ]; then
-    framework="$(python3 -c "import json; d=json.load(open('$pkg')); print(d.get('framework','?'))" 2>/dev/null || echo "?")"
-    echo "- **$name**: $framework"
-  else
-    echo "- **$name**: (no package.json)"
-  fi
-done
-echo ""
-
-# 2. API surface
-echo "## API Surface"
-echo ""
-if [ -d "$PROJECT_ROOT/aidlc/contracts/api" ]; then
-  find "$PROJECT_ROOT/aidlc/contracts/api" -name "*.yaml" -o -name "*.yml" | while read -r f; do
-    echo "- $(basename "$f")"
-  done
-else
-  echo "(No contract files discovered)"
-fi
-echo ""
-
-# 3. Dependency map (simplified)
-echo "## Dependency Map"
-echo ""
-echo '```mermaid'
-echo 'graph LR'
-for comp_dir in "$PROJECT_ROOT"/apps/*/; do
-  name="$(basename "$comp_dir")"
-  pkg="$comp_dir/package.json"
-  if [ -f "$pkg" ]; then
-    python3 -c "
-import json
-d=json.load(open('$pkg'))
-for dep in d.get('dependencies',{}):
-    print(f'  {name} -->|depends| {dep}')
-for dep in d.get('devDependencies',{}):
-    pass
-" 2>/dev/null || true
-  fi
-done
-echo '```'
-echo ""
-
-echo "---"
-echo "Generated by brownfield/generate-context.sh"

package/ai-dlc-skill/brownfield/scripts/deps.sh

@@ -1,27 +0,0 @@
-#!/usr/bin/env bash
-# deps.sh — Cross-component dependency graph generator
-set -euo pipefail
-
-PROJECT_ROOT="$(cd "$(dirname "$0")/../../.." && pwd)"
-
-echo '```mermaid'
-echo 'graph LR'
-
-for comp_dir in "$PROJECT_ROOT"/apps/*/; do
-  name=$(basename "$comp_dir")
-  pkg="$comp_dir/package.json"
-
-  if [ -f "$pkg" ]; then
-    # Internal cross-component dependencies via workspace references
-    python3 -c "
-import json
-d = json.load(open('$pkg'))
-for dep_type in ['dependencies', 'devDependencies']:
-    for dep in d.get(dep_type, {}):
-        if dep.startswith('@') or dep.startswith('packages/'):
-            print(f'  {name} -->|depends| {dep}')
-" 2>/dev/null || true
-  fi
-done
-
-echo '```'

package/ai-dlc-skill/brownfield/scripts/discover.sh

@@ -1,34 +0,0 @@
-#!/usr/bin/env bash
-# discover.sh — Component discovery for brownfield projects
-set -euo pipefail
-
-PROJECT_ROOT="$(cd "$(dirname "$0")/../../.." && pwd)"
-
-echo "{
-  \"components\": ["
-
-first=true
-for comp_dir in "$PROJECT_ROOT"/apps/*/; do
-  name=$(basename "$comp_dir")
-  pkg="$comp_dir/package.json"
-  $first || echo ","
-  first=false
-
-  if [ -f "$pkg" ]; then
-    python3 -c "
-import json
-d=json.load(open('$pkg'))
-print(json.dumps({
-    'id': '$name',
-    'path': '$comp_dir',
-    'name': d.get('name', '$name'),
-    'framework': d.get('framework', '?'),
-    'language': d.get('language', '?'),
-}, indent=2))
-" 2>/dev/null || echo "{\"id\": \"$name\", \"path\": \"$comp_dir\"}"
-  else
-    echo "{\"id\": \"$name\", \"path\": \"$comp_dir\", \"warning\": \"no package.json\"}"
-  fi
-done
-
-echo "]}"

package/ai-dlc-skill/brownfield/scripts/extract-api.sh

@@ -1,45 +0,0 @@
-#!/usr/bin/env bash
-# extract-api.sh — Extract API surface from aidlc/contracts/ directory
-set -euo pipefail
-
-PROJECT_ROOT="$(cd "$(dirname "$0")/../../.." && pwd)"
-
-echo "# API Surface"
-echo ""
-
-if [ ! -d "$PROJECT_ROOT/aidlc/contracts" ]; then
-  echo "(No aidlc/contracts/ directory found)"
-  exit 0
-fi
-
-# OpenAPI
-for f in "$PROJECT_ROOT"/aidlc/contracts/api/*.yaml "$PROJECT_ROOT"/aidlc/contracts/api/*.yml; do
-  [ -f "$f" ] || continue
-  echo "## File: $(basename "$f")"
-  python3 -c "
-import yaml, json
-d = yaml.safe_load(open('$f'))
-if 'paths' in d:
-    for path, methods in d['paths'].items():
-        for method, spec in methods.items():
-            print(f\"  {method.upper()} {path} — {spec.get('summary', '?')}\")
-if 'info' in d:
-    print(f\"  Title: {d['info'].get('title', '?')}\")
-    print(f\"  Version: {d['info'].get('version', '?')}\")
-" 2>/dev/null || echo "  (parse error)"
-  echo ""
-done
-
-# AsyncAPI
-for f in "$PROJECT_ROOT"/aidlc/contracts/events/*.yaml "$PROJECT_ROOT"/aidlc/contracts/events/*.yml; do
-  [ -f "$f" ] || continue
-  echo "## File: $(basename "$f")"
-  python3 -c "
-import yaml
-d = yaml.safe_load(open('$f'))
-channels = d.get('channels', {})
-for name, ch in channels.items():
-    print(f\"  Channel: {name}\")
-" 2>/dev/null || echo "  (parse error)"
-  echo ""
-done

package/ai-dlc-skill/components/backend.md

@@ -1,47 +0,0 @@
-# Backend 组件开发指南 (BE-FR-*)
-
-## 技术栈
-- 语言: Python / Node.js / Go
-- 框架: FastAPI / Express / Gin (传统 server)
-- 云函数: CloudBase Functions (SCF) / CloudBase Run (container)
-- 构建: poetry / pnpm / go build
-- 测试: pytest / vitest / go test
-- BDD: pytest-bdd
-
-## 计算模式
-
-| 模式 | 类型 | 说明 | 超时 | 内存 |
-|------|------|------|------|------|
-| cloudbase-functions | FaaS | CloudBase Functions (SCF)，事件驱动云函数 | 60s | 1536MB |
-| cloudbase-run | CaaS | CloudBase Run，容器托管 | 3600s | 4096MB |
-| server | 传统 | FastAPI / Express / Gin 等框架运行在服务器上 | — | — |
-
-默认模式: `cloudbase-functions`（TCB 平台）。
-
-## 关键命令
-- 构建: `pnpm --filter backend build`
-- 测试全部: `pnpm --filter backend test`
-- BDD: `pytest-bdd apps/backend/features/`
-- Lint: `pnpm --filter backend lint`
-- DB 迁移: `tcb db migrate` / `rds migrate`
-- 部署云函数: `tcb fn deploy --env {env}`
-- 部署容器: `tcb run deploy --env {env}`
-
-## 目录约定
-- `src/` → 组件源码（按模块组织）
-- `tests/unit/` → 单元测试
-- `tests/integration/` → 集成测试（含 DB）
-- `tests/e2e/` → E2E 测试（对 preview URL）
-- `features/` → BDD feature 文件
-- `features/steps/` → BDD step definitions
-
-## FR 命名空间
-- Prefix: BE-FR-NNN
-- 范围: 服务端/API 行为
-
-## 特定约束
-- 后端组件是 Stack 部署的入口点（先部署再暴露 BACKEND_URL）
-- API 合约定义在 `aidlc/contracts/api/`（OpenAPI 3.1）
-- 依赖注入使用 provider pattern
-- 所有输入必须验证（SEC-002）
-- DB 查询必须使用参数化语句（SEC-003）

package/ai-dlc-skill/components/desktop.md

@@ -1,63 +0,0 @@
-# Desktop 组件开发指南 (DESKTOP-FR-*)
-
-## 技术栈
-- 框架: Electron / Tauri
-- 语言: TypeScript (Electron) / Rust + TS (Tauri)
-- 构建: `pnpm build:desktop`
-- 测试: Vitest / Jest
-- BDD: Spectron / WebDriverIO
-
-## 关键命令
-- 构建: `pnpm --filter desktop build`
-- 测试全部: `pnpm --filter desktop test`
-- BDD: `spectron test`
-- Lint: `pnpm --filter desktop lint`
-
-## 目录约定
-- `src/` → 组件源码
-- `tests/unit/` → 单元测试
-- `tests/e2e/` → E2E 测试
-- `features/` → BDD feature 文件
-- `features/steps/` → BDD step definitions
-
-## FR 命名空间
-- Prefix: DESKTOP-FR-NNN
-- 范围: 桌面端行为（macOS + Windows + Linux）
-
-## 特定约束
-- Desktop 组件依赖 `BACKEND_URL` 在构建时注入
-- 支持离线模式（本地优先）
-- 自动更新通过内置更新器
-
-## Design System 规范
-
-### 必读规范
-| 规范 | 路径 |
-|------|------|
-| Design Tokens | `phases/plan/design_system/design_tokens.md` |
-| Atomic Design | `phases/plan/design_system/atomic_design.md` |
-| Component Spec | `phases/plan/design_system/component_spec.md` |
-| Accessibility | `phases/plan/design_system/accessibility.md` |
-| Theme System | `phases/plan/design_system/theme_system.md` |
-| Desktop UI | `phases/plan/design_system/platform_ui/desktop.md` |
-| Iconography | `phases/plan/design_system/iconography.md` |
-
-### 窗口规范
-| 项目 | 最小尺寸 | 默认尺寸 |
-|------|----------|----------|
-| 通用应用 | 1024x600 | 1280x800 |
-| 复杂工具 | 1280x720 | 1440x900 |
-
-### 平台菜单规范
-| 平台 | 菜单 |
-|------|------|
-| macOS | 原生菜单 (App/File/Edit/View/Window/Help) |
-| Windows | 原生标题栏 + 上下文菜单 |
-| Linux | 原生标题栏 |
-
-### 原生能力
-- 窗口管理: 最小化/最大化/关闭
-- 系统托盘: 后台运行指示器
-- 全局快捷键: 设置/偏好设置/帮助
-- 文件对话框: 打开/保存
-- 拖拽: 支持拖拽文件到窗口