@scemoon/cdh 1.0.5 → 1.0.7

package/ai-dlc-skill/practices/sdd.md

@@ -1,84 +0,0 @@
-# Spec-Driven Development (SDD)
-
-SDD is the specification methodology used in Understand and Plan phases.
-
-## Role in AI-DLC
-
-| Phase | SDD Usage |
-|-------|-----------|
-| Understand | Intent capture, spec delta with EARS |
-| Plan | Design doc, task decomposition with DAG |
-| Deliver | Artifact archiving |
-
-## Core Artifacts
-
-### Proposal (Why/What/Impact)
-
-```markdown
-## Change: CHG-001 — User Authentication
-
-**Why:** Users need to securely access their accounts
-**What:** Email + password login with JWT session
-**Impact:** New auth module, changes to user model
-```
-
-### Spec Delta (EARS)
-
-```markdown
-## ADDED Requirements
-
-### FR-001: User Authentication
-
-**Priority:** P0
-
-**Description (Event-Driven):**
-When a user submits valid credentials, the system SHALL authenticate and return a JWT token.
-
-**Acceptance Criteria:**
-- AC1: Valid credentials return JWT with 1-hour expiry
-- AC2: Invalid credentials return 401
-- AC3: Empty fields return validation error
-```
-
-### Design Doc
-
-```markdown
-## Data Model: User
-
-| Field | Type | Constraints |
-|-------|------|-------------|
-| id | UUID | PK |
-| email | string | UNIQUE, NOT NULL |
-
-## API: POST /auth/login
-
-Request: `{email, password}`  Response: `{token, expires_in}`
-```
-
-### Task List with DAG
-
-```yaml
-units:
-  - id: unit-1
-    name: Database schema
-    depends_on: []
-  - id: unit-2
-    name: Login endpoint
-    depends_on: [unit-1]
-```
-
-## EARS Patterns
-
-| Pattern | Syntax | Example |
-|---------|--------|---------|
-| Ubiquitous | `The system SHALL ...` | Always-hash passwords with bcrypt |
-| Event-Driven | `When {event}, SHALL ...` | When user logs in, create session |
-| State-Driven | `While {state}, SHALL ...` | While session active, auto-refresh |
-| Unwanted | `If {condition}, SHALL ...` | If DB fails, return 503 |
-| Optional | `Where {feature}, SHALL ...` | Where SSO enabled, skip password |
-
-## Tools
-
-- Spec format: Markdown with EARS
-- Design: Markdown + Mermaid diagrams
-- Tasks: YAML with DAG structure

package/ai-dlc-skill/practices/tdd.md

@@ -1,95 +0,0 @@
-# Test-Driven Development (TDD)
-
-TDD is the implementation methodology used in the Verify phase.
-
-## Role in AI-DLC
-
-| Phase | TDD Usage |
-|-------|-----------|
-| Plan | Test plan written per scenario |
-| Verify | Red → Green → Refactor per BDD scenario |
-
-## Core Cycle
-
-```
-For each BDD scenario:
-  ┌──────────────────┐
-  │  1. RED          │  Write pytest test → confirm FAILURE
-  │  2. GREEN        │  Write minimum implementation → confirm PASS
-  │  3. REFACTOR     │  Clean up → all tests still PASS
-  └──────────────────┘
-```
-
-## RED Phase
-
-Write a test that asserts the expected behavior. It must fail on first run.
-
-```python
-# tests/unit/test_auth.py
-def test_login_valid_credentials():
-    result = authenticate("user@test.com", "correct123")
-    assert result.token is not None
-    assert result.expires_in == 3600
-```
-
-```bash
-pytest tests/unit/test_auth.py -v
-# FAILED — authenticate not defined  ✓ (RED confirmed)
-```
-
-**Rules:**
-- Test written before implementation code
-- Test must fail (confirms the assertion is valid)
-- Test covers only this scenario's behavior
-
-## GREEN Phase
-
-Write the minimum code to make the test pass.
-
-```python
-# src/auth/login.py
-def authenticate(email, password):
-    if email == "user@test.com" and password == "correct123":
-        return AuthResult(token="jwt_placeholder", expires_in=3600)
-    raise AuthError("Invalid credentials")
-```
-
-```bash
-pytest tests/unit/test_auth.py -v
-# PASSED  ✓ (GREEN)
-```
-
-**Rules:**
-- Minimum code to pass — no extras
-- No premature optimization
-- No new dependencies unless required
-
-## REFACTOR Phase
-
-Improve code quality without changing behavior.
-
-```bash
-pytest --cov --cov-fail-under=80
-# All tests passed, coverage ≥80%  ✓ (REFACTOR)
-```
-
-**Rules:**
-- Keep all tests green
-- No behavior changes
-- Repeat for next scenario
-
-## Naming Convention
-
-| Artifact | Location | Example |
-|----------|----------|---------|
-| Tests | `tests/unit/test_{feature}.py` | `tests/unit/test_auth.py` |
-| Step defs | `features/steps/test_{feature}_steps.py` | `features/steps/test_login_steps.py` |
-| Source | `src/{module}/{feature}.py` | `src/auth/login.py` |
-
-## Quality Gates
-
-```bash
-pytest --cov --cov-fail-under=80
-pytest-bdd features/ --verbose
-bandit -r src/ -q
-```

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

@@ -1,114 +0,0 @@
-# Cloud Providers
-
-## Default: TCB (Tencent CloudBase)
-
-TCB is the default cloud development platform. Aliyun is also supported.
-
-The provider layer supports a **monorepo multi-component stack** (native + desktop + web + backend + wxa + mya + tta). Use the `deploy_stack` orchestrator instead of per-component CLI commands for shared environments.
-
-## Provider Comparison
-
-| Capability | TCB | Aliyun |
-|-----------|-----|--------|
-| **Functions** | CloudBase Functions | Function Compute (FC) |
-| **Database** | DocDB + MySQL | TableStore + RDS |
-| **Storage** | COS (Cloud Object Storage) | OSS (Object Storage Service) |
-| **Hosting** | CloudBase Hosting + Preview | Static Website + CDN |
-| **Stack preview URL** | `https://{env-id}.tcb-preview.com` (gateway) | `https://{gateway}.{region}.fc.devs.com` |
-| **Default** | Yes | No |
-
-## Stack Deploy
-
-`deploy_stack` is the unified orchestrator. It deploys `backend` first, captures `BACKEND_URL`, then deploys all client components with `BACKEND_URL` injected. The output is `STACK_URL` (= `BACKEND_URL`) plus per-component URLs.
-
-```bash
-deploy_stack --preview --provider tcb
-# → STACK_URL=https://{env-id}.tcb-preview.com
-# → WEB_URL=https://{env-id}-{project}.tcb-preview.com
-# → NATIVE_DIST_URL=internal distribution URL
-# → DESKTOP_DIST_URL=internal distribution URL
-# → WXA_URL/MYA_URL/TTA_URL=mini-program preview QR
-```
-
-```bash
-deploy_stack --preview --provider aliyun
-# → STACK_URL=https://{gateway}.{region}.fc.devs.com
-# → WEB_URL=https://{bucket}.{region}.oss-website.aliyuncs.com
-# → NATIVE_DIST_URL=internal distribution URL
-# → DESKTOP_DIST_URL=internal distribution URL
-# → WXA_URL/MYA_URL/TTA_URL=mini-program preview QR
-```
-
-## Build Config Injection
-
-All client builds receive `BACKEND_URL` at build time. The orchestrator passes it; components must not hardcode URLs.
-
-```bash
-# web
-pnpm --filter web build --env BACKEND_URL=$BACKEND_URL
-
-# native
-cd apps/native && BACKEND_URL=$BACKEND_URL pnpm build
-
-# desktop
-cd apps/desktop && BACKEND_URL=$BACKEND_URL pnpm build
-
-# mini-programs (wxa, mya, tta)
-cd apps/wxa && BACKEND_URL=$BACKEND_URL pnpm build
-cd apps/mya && BACKEND_URL=$BACKEND_URL pnpm build
-cd apps/tta && BACKEND_URL=$BACKEND_URL pnpm build
-```
-
-## Component URL Resolution
-
-| Component | TCB | Aliyun |
-|-----------|-----|--------|
-| `backend` (gateway) | `https://{env-id}.tcb-preview.com` | `https://{gateway}.{region}.fc.devs.com` |
-| `web` (hosting) | `https://{env-id}-{project}.tcb-preview.com` | `https://{bucket}.{region}.oss-website.aliyuncs.com` |
-| `native` (distribution) | internal distribution URL | internal distribution URL |
-| `desktop` (distribution) | internal distribution URL | internal distribution URL |
-| `wxa` (mini-program) | mini-program preview QR | mini-program preview QR |
-| `mya` (mini-program) | mini-program preview QR | mini-program preview QR |
-| `tta` (mini-program) | mini-program preview QR | mini-program preview QR |
-
-## BDD E2E Targets
-
-| Test | Target |
-|------|--------|
-| `apps/backend/tests/e2e/` | `BACKEND_URL` |
-| `apps/web/tests/e2e/` | `WEB_URL` + `BACKEND_URL` (as API root) |
-| `apps/native/tests/e2e/` | `BACKEND_URL` (built into app) |
-| `apps/desktop/tests/e2e/` | `BACKEND_URL` (built into app) |
-| `apps/wxa/tests/e2e/` | `BACKEND_URL` (built into app) |
-| `apps/mya/tests/e2e/` | `BACKEND_URL` (built into app) |
-| `apps/tta/tests/e2e/` | `BACKEND_URL` (built into app) |
-| `aidlc/tests/cross-stack/` | `STACK_URL` (full flow) |
-
-## Dynamic Preview URL
-
-Preview URLs are resolved at deploy time based on the active provider:
-
-- **TCB:** `deploy_stack --preview --provider tcb` → `STACK_URL=https://{env-id}.tcb-preview.com`
-- **Aliyun:** `deploy_stack --preview --provider aliyun` → `STACK_URL=https://{gateway}.{region}.fc.devs.com`
-
-Set as `STACK_URL` / `BACKEND_URL` / `WEB_URL` / per-component URLs as environment variables for BDD e2e tests:
-
-```bash
-export STACK_URL=$(deploy_stack --preview --output url)
-export BACKEND_URL=$STACK_URL
-export WEB_URL=$(deploy_stack --preview --output web_url)
-export NATIVE_URL=$(deploy_stack --preview --output native_url)
-export DESKTOP_URL=$(deploy_stack --preview --output desktop_url)
-pytest apps/web/tests/e2e/ --base-url $WEB_URL --api-url $BACKEND_URL
-pytest apps/native/tests/e2e/ --backend-url $BACKEND_URL
-pytest apps/desktop/tests/e2e/ --backend-url $BACKEND_URL
-pytest aidlc/tests/cross-stack/ --stack-url $STACK_URL
-```
-
-## Stack Rollback
-
-Rollback is at the **stack** level: backend and all client components revert together to the last stable stack version.
-
-```bash
-deploy_stack --rollback ${LAST_STABLE_STACK_VERSION} --provider tcb
-```

package/ai-dlc-skill/providers/aliyun/deployment.yaml

@@ -1,66 +0,0 @@
-# Aliyun Stack Deployment
-
-Production deployment pipeline for Aliyun. The default is the unified `deploy_stack` orchestrator; per-component deploys are only allowed into isolated dev sandboxes.
-
-## Environments
-
-| Environment | Purpose | Deploy Trigger | Orchestrator |
-|-------------|---------|----------------|--------------|
-| preview | Per-component + cross-stack e2e | Feature branch | `deploy_stack --preview` |
-| staging | Pre-production stack validation | PR merge to main | `deploy_stack --env staging` |
-| production | Live traffic | Release tag + human approval | `deploy_stack --env production` |
-
-## Stack Deploy Steps
-
-```yaml
-staging:
-  orchestrator: deploy_stack
-  steps:
-    - fun deploy --env staging                   # backend
-    - rds migrate --env staging                  # backend (or tablestore)
-    - oss sync ./dist oss://bucket-staging/      # web
-    - cdn refresh --domain staging.example.com   # web
-    - native build with BACKEND_URL injected     # native
-    - desktop build with BACKEND_URL injected    # desktop
-    - wxa build with BACKEND_URL injected        # wxa
-    - mya build with BACKEND_URL injected        # mya
-    - tta build with BACKEND_URL injected        # tta
-    - smoke-test ${STACK_URL}
-
-production:
-  orchestrator: deploy_stack
-  pre_conditions:
-    - human-approval-gate
-  steps:
-    - fun deploy --env production --publish
-    - rds migrate --env production
-    - oss sync ./dist oss://bucket-production/
-    - cdn refresh --domain example.com
-    - native build with BACKEND_URL injected
-    - desktop build with BACKEND_URL injected
-    - wxa build with BACKEND_URL injected
-    - mya build with BACKEND_URL injected
-    - tta build with BACKEND_URL injected
-    - smoke-test ${PRODUCTION_URL}
-    - health-check ${PRODUCTION_URL}/health
-    - bvt ${PRODUCTION_URL}
-```
-
-## Per-Component Dev Sandbox (allowed)
-
-```bash
-# Personal dev sandbox — one user, one component
-fun deploy --function hello --env dev-${USER}
-oss cp -r ./dist oss://{dev-bucket}/ --update
-# Per-component deploys to shared envs (preview/staging/production) are forbidden
-```
-
-## Stack Rollback
-
-```bash
-# Automatic on BVT failure
-deploy_stack --rollback ${LAST_STABLE_STACK_VERSION} --provider aliyun
-
-# Manual on demand
-deploy_stack --rollback --stack-version v1.2.3 --provider aliyun
-```

package/ai-dlc-skill/providers/aliyun/preview.yaml

@@ -1,84 +0,0 @@
-# Aliyun Stack Preview
-
-Preview deployment for the unified stack (backend + all clients: web, native, desktop, wxa, mya, tta). URL resolution is dynamic per platform; `BACKEND_URL` is injected into client builds at build time.
-
-## Overview
-
-`deploy_stack --preview --provider aliyun` deploys the full stack to an isolated preview environment and exports the stack URL. Used for per-component e2e AND cross-stack e2e verification before staging or production.
-
-## Preview Flow
-
-```
-git push feature branch
-  → deploy_stack --preview --provider aliyun
-  → STACK_URL = BACKEND_URL = https://{gateway}.{region}.fc.devs.com
-  → WEB_URL  = https://{bucket}.{region}.oss-website.aliyuncs.com
-  → NATIVE_DIST_URL = internal distribution URL
-  → DESKTOP_DIST_URL = internal distribution URL
-  → WXA_URL / MYA_URL / TTA_URL = mini-program preview QR
-  → Per-component e2e: pytest apps/{comp}/tests/e2e/ --base-url $URL
-  → Cross-stack e2e:  pytest aidlc/tests/cross-stack/ --stack-url $STACK_URL
-  → TTL: 24h → auto cleanup
-```
-
-## Configuration
-
-```yaml
-preview:
-  orchestrator: deploy_stack
-  strategy: unified
-  ttl: 24h
-  auto_cleanup: true
-  db_sandbox: true          # isolated DB per preview
-  url_pattern_backend: "https://{gateway}.{region}.fc.devs.com"
-  url_pattern_web:     "https://{bucket}.{region}.oss-website.aliyuncs.com"
-  build_env:
-    web:
-      - BACKEND_URL
-      - STACK_URL
-    native:
-      - BACKEND_URL
-    desktop:
-      - BACKEND_URL
-    wxa:
-      - BACKEND_URL
-    mya:
-      - BACKEND_URL
-    tta:
-      - BACKEND_URL
-  env:
-    - STACK_URL             # = BACKEND_URL (gateway)
-    - BACKEND_URL
-    - WEB_URL
-    - NATIVE_DIST_URL
-    - DESKTOP_DIST_URL
-    - WXA_URL
-    - MYA_URL
-    - TTA_URL
-    - DATABASE_URL (sandbox)
-```
-
-## BDD E2E Integration
-
-```bash
-# Deploy unified stack preview
-export STACK_URL=$(deploy_stack --preview --provider aliyun --output url)
-export BACKEND_URL=$STACK_URL
-export WEB_URL=$(deploy_stack --preview --provider aliyun --output web_url)
-export NATIVE_DIST_URL=$(deploy_stack --preview --provider aliyun --output native_url)
-export DESKTOP_DIST_URL=$(deploy_stack --preview --provider aliyun --output desktop_url)
-
-# Per-component e2e
-pytest apps/backend/tests/e2e/ --base-url $BACKEND_URL
-pytest apps/web/tests/e2e/ --base-url $WEB_URL --api-url $BACKEND_URL
-pytest apps/native/tests/e2e/ --backend-url $BACKEND_URL
-pytest apps/desktop/tests/e2e/ --backend-url $BACKEND_URL
-pytest apps/wxa/tests/e2e/ --backend-url $BACKEND_URL
-pytest apps/mya/tests/e2e/ --backend-url $BACKEND_URL
-pytest apps/tta/tests/e2e/ --backend-url $BACKEND_URL
-
-# Cross-stack e2e
-pytest aidlc/tests/cross-stack/ --stack-url $STACK_URL
-
-# Cleanup (automatic after TTL)
-```

package/ai-dlc-skill/providers/aliyun/provider.yaml

@@ -1,160 +0,0 @@
-# Aliyun Provider (Stack-aware)
-
-Aliyun (Alibaba Cloud) provider — secondary platform. Supports the unified stack deploy (backend + all clients: web, native, desktop, wxa, mya, tta) and per-component deploys (for isolated dev sandboxes only).
-
-## Metadata
-
-```yaml
-provider:
-  name: aliyun
-  display_name: Alibaba Cloud
-  default: false
-  version: 3.0.0
-  website: https://www.aliyun.com/
-
-stack:
-  components:
-    - id: backend
-      deploy_order: 1
-      exposes: BACKEND_URL
-    - id: web
-      deploy_order: 2
-      consumes: BACKEND_URL
-    - id: native
-      deploy_order: 2
-      consumes: BACKEND_URL
-    - id: desktop
-      deploy_order: 2
-      consumes: BACKEND_URL
-    - id: wxa
-      deploy_order: 2
-      consumes: BACKEND_URL
-    - id: mya
-      deploy_order: 2
-      consumes: BACKEND_URL
-    - id: tta
-      deploy_order: 2
-      consumes: BACKEND_URL
-
-regions:
-  - id: cn-shanghai
-    name: Shanghai
-  - id: cn-beijing
-    name: Beijing
-  - id: cn-hangzhou
-    name: Hangzhou
-  - id: ap-southeast-1
-    name: Singapore
-
-services:
-  - functions: function-compute
-  - database: rds + tablestore
-  - storage: oss
-  - hosting: static-website + cdn
-
-limits:
-  function_timeout: 600s
-  function_memory: 3072MB
-
-compute_modes:
-  - id: fc
-    type: faas
-    default: true
-    description: "Function Compute — event-driven functions"
-    limits:
-      timeout: 600s
-      memory: 3072MB
-  - id: sae
-    type: caas
-    description: "Serverless App Engine 2.0 — container/web app hosting"
-    limits:
-      timeout: 86400s
-      memory: 32768MB
-
-capabilities:
-  - function_compute
-  - serverless_app_engine
-  - oss_storage
-  - rds_database
-  - tablestore
-  - static_hosting
-  - cdn_acceleration
-  - preview_deploy
-  - ssl_cert
-  - stack_deploy
-  - build_env_injection
-```
-
-## Stack Deploy (recommended for shared environments)
-
-```bash
-# Unified stack preview
-deploy_stack --preview --provider aliyun
-# → backend:  fun deploy --env preview
-# → web:      oss + cdn deploy with build env BACKEND_URL=${STACK_URL}
-# → native:   build with BACKEND_URL injected; package
-# → desktop:  build with BACKEND_URL injected; package
-# → wxa:      build with BACKEND_URL injected; upload to mini-program platform
-# → mya:      build with BACKEND_URL injected; upload to mini-program platform
-# → tta:      build with BACKEND_URL injected; upload to mini-program platform
-# → STACK_URL = https://{gateway}.{region}.fc.devs.com
-
-deploy_stack --env staging --provider aliyun
-deploy_stack --env production --provider aliyun
-deploy_stack --rollback ${LAST_STABLE_STACK_VERSION} --provider aliyun
-```
-
-## Per-Component Deploy (dev sandboxes only)
-
-```bash
-# Functions
-fun deploy --function hello
-
-# Storage (OSS)
-oss cp ./file.txt oss://bucket/path/
-oss ls oss://bucket/
-
-# Database (RDS / TableStore)
-# RDS: standard MySQL/PostgreSQL CLI
-# TableStore: ots search
-
-# Hosting (web only, dev sandbox)
-oss cp -r ./dist oss://{dev-bucket}/ && cdn refresh
-
-# Environment
-fun config --account-id <id>
-fun config --region cn-shanghai
-```
-
-> Per-component deploys to shared environments are forbidden (STK-004). Use `deploy_stack`.
-
-## URL Resolution
-
-| Component | Pattern |
-|-----------|---------|
-| `STACK_URL` / `BACKEND_URL` | `https://{gateway}.{region}.fc.devs.com` |
-| `WEB_URL` | `https://{bucket}.{region}.oss-website.aliyuncs.com` |
-| `NATIVE_DIST_URL` | internal distribution URL |
-| `DESKTOP_DIST_URL` | internal distribution URL |
-| `WXA_URL` | mini-program preview QR |
-| `MYA_URL` | mini-program preview QR |
-| `TTA_URL` | mini-program preview QR |
-
-## Build Config Injection
-
-```bash
-BACKEND_URL=$STACK_URL pnpm --filter web build
-oss cp -r ./dist oss://{bucket}/ --update
-cdn refresh
-```
-
-## Environment Variables
-
-| Variable | Description |
-|----------|-------------|
-| ALICLOUD_ACCESS_KEY | Aliyun access key ID |
-| ALICLOUD_SECRET_KEY | Aliyun access key secret |
-| ALICLOUD_REGION | Default region |
-| FUNCTION_COMPUTE_SERVICE | FC service name |
-| BACKEND_URL | Stack URL injected at build time |
-| STACK_URL | Alias of BACKEND_URL (gateway) |

package/ai-dlc-skill/providers/tcb/deployment.yaml

@@ -1,69 +0,0 @@
-# TCB Stack Deployment
-
-Production deployment pipeline for TCB. The default is the unified `deploy_stack` orchestrator; per-component deploys are only allowed into isolated dev sandboxes.
-
-## Environments
-
-| Environment | Purpose | Deploy Trigger | Orchestrator |
-|-------------|---------|----------------|--------------|
-| preview | Per-component + cross-stack e2e | Feature branch | `deploy_stack --preview` |
-| staging | Pre-production stack validation | PR merge to main | `deploy_stack --env staging` |
-| production | Live traffic | Release tag + human approval | `deploy_stack --env production` |
-
-## Stack Deploy Steps
-
-```yaml
-staging:
-  orchestrator: deploy_stack
-  steps:
-    - tcb fn deploy --env staging            # backend
-    - tcb db migrate --env staging           # backend
-    - tcb hosting deploy --env staging \
-        --build-env BACKEND_URL=${STACK_URL}  # web
-    - native build with BACKEND_URL injected  # native
-    - desktop build with BACKEND_URL injected # desktop
-    - wxa build with BACKEND_URL injected     # wxa
-    - mya build with BACKEND_URL injected     # mya
-    - tta build with BACKEND_URL injected     # tta
-    - smoke-test ${STACK_URL}
-
-production:
-  orchestrator: deploy_stack
-  pre_conditions:
-    - human-approval-gate
-  steps:
-    - tcb fn deploy --env production
-    - tcb db migrate --env production
-    - tcb hosting deploy --env production \
-        --build-env BACKEND_URL=${STACK_URL}
-    - native build with BACKEND_URL injected
-    - desktop build with BACKEND_URL injected
-    - wxa build with BACKEND_URL injected
-    - mya build with BACKEND_URL injected
-    - tta build with BACKEND_URL injected
-    - smoke-test ${PRODUCTION_URL}
-    - health-check ${PRODUCTION_URL}/health
-    - bvt ${PRODUCTION_URL}
-```
-
-## Per-Component Dev Sandbox (allowed)
-
-```bash
-# Personal dev sandbox — one user, one component
-tcb env create dev-${USER}
-tcb fn deploy --name hello --dir ./functions --env dev-${USER}
-tcb hosting deploy --env dev-${USER}
-# Per-component deploys to shared envs (preview/staging/production) are forbidden
-```
-
-## Stack Rollback
-
-```bash
-# Automatic on BVT failure
-deploy_stack --rollback ${LAST_STABLE_STACK_VERSION} --provider tcb
-
-# Manual on demand
-deploy_stack --rollback --stack-version v1.2.3 --provider tcb
-```
-
-The previous stable stack version is identified by the last green BVT.