@scemoon/cdh 1.0.3 → 1.0.5

package/cdh/cdh_skill_manager.py

@@ -0,0 +1,105 @@
+"""cdh platform skill manager — operates ~/.cdh/skills/<name>/.
+
+This is the cdh platform equivalent of onecode.skills.manager.SkillManager,
+but operates strictly on ~/.cdh/skills/ (cdh platform shared pool).
+Engines (onecode/opencode/claude) do NOT read this directory directly;
+cdh injects platform skills into engines at runtime via prompt or env var.
+"""
+
+from __future__ import annotations
+
+import shutil
+from pathlib import Path
+from typing import Optional
+
+import yaml
+
+
+CDH_PLATFORM_SKILLS_DIR = Path.home() / ".cdh" / "skills"
+
+
+class CdhSkillManager:
+    def __init__(self, skills_dir: Path | None = None):
+        self.skills_dir = skills_dir or CDH_PLATFORM_SKILLS_DIR
+        self.skills_dir.mkdir(parents=True, exist_ok=True)
+        self._skills: dict[str, dict] = {}
+
+    def install(self, path: Path) -> Optional[str]:
+        """Install a skill from source path into the cdh platform skill pool.
+
+        Copies the entire skill directory to ~/.cdh/skills/<name>/,
+        and writes .installed_version with the source's metadata.version.
+        Returns error message or None on success.
+        """
+        skill_yaml = path / "skill.yaml"
+        if not skill_yaml.exists():
+            return "skill.yaml not found in source"
+
+        data = yaml.safe_load(skill_yaml.read_text())
+        name = data.get("name", path.name)
+        target = self.skills_dir / name
+        target.mkdir(parents=True, exist_ok=True)
+
+        for src in path.iterdir():
+            if src.name.startswith("."):
+                continue
+            dst = target / src.name
+            if src.is_dir():
+                shutil.copytree(src, dst, dirs_exist_ok=True)
+            else:
+                shutil.copy2(src, dst)
+
+        # Write version marker
+        version = data.get("metadata", {}).get("version", "4.0.0")
+        version_file = target / ".installed_version"
+        version_file.write_text(version + "\n", encoding="utf-8")
+
+        self._skills[name] = data
+        return None
+
+    def list(self) -> list[dict]:
+        result = []
+        for d in self.skills_dir.iterdir():
+            if d.is_dir():
+                config_path = d / "skill.yaml"
+                if config_path.exists():
+                    data = yaml.safe_load(config_path.read_text()) or {}
+                    data["name"] = data.get("name", d.name)
+                    data["enabled"] = data.get("enabled", True)
+                    result.append(data)
+        return result
+
+    def enable(self, name: str, enabled: bool = True):
+        config_path = self.skills_dir / name / "skill.yaml"
+        if config_path.exists():
+            data = yaml.safe_load(config_path.read_text()) or {}
+            data["enabled"] = enabled
+            config_path.write_text(yaml.dump(data, default_flow_style=False))
+
+    def get_installed_version(self, name: str) -> Optional[str]:
+        version_file = self.skills_dir / name / ".installed_version"
+        if version_file.exists():
+            return version_file.read_text(encoding="utf-8").strip()
+        return None
+
+    def remove(self, name: str) -> Optional[str]:
+        skill_path = self.skills_dir / name
+        if not skill_path.exists():
+            return f"Skill '{name}' not found"
+        if not skill_path.is_dir():
+            return f"'{name}' is not a skill directory"
+        shutil.rmtree(skill_path)
+        self._skills.pop(name, None)
+        return None
+
+    def get(self, name: str) -> Optional[dict]:
+        if name in self._skills:
+            return self._skills[name]
+        skill_path = self.skills_dir / name / "skill.yaml"
+        if skill_path.exists():
+            data = yaml.safe_load(skill_path.read_text()) or {}
+            data["name"] = data.get("name", name)
+            data["enabled"] = data.get("enabled", True)
+            self._skills[name] = data
+            return data
+        return None

package/cdh/cli.py

@@ -5,9 +5,7 @@ import click
 
 from cdh.scaffold import (
     COMPONENTS,
-    COMPONENT_BY_ID,
     CROSS_CUTTING,
-    CROSS_CUTTING_BY_ID,
     add_component,
     add_cross_cutting,
     init_dlc_project,
@@ -146,8 +144,15 @@ _ONECODE_HELP_OVERRIDES: dict[str, tuple[str, str]] = {
         "Manage the onecode codebase index",
         "Build and query onecode's local codebase index. Used by the "
         "agent to ground answers in the project's own source files. "
+        "Index stored at ~/.onecode/codebase/indexes/. "
         "Sub-commands: index, reindex, status, search.",
     ),
+    "memory": (
+        "Manage onecode long-term memory",
+        "View and manage onecode's long-term conversation memory. "
+        "Memory stored at ~/.onecode/memory/ with BM25 recall. "
+        "Sub-commands: status, clear, count.",
+    ),
     "skill": (
         "Manage onecode skills",
         "Install, enable, disable, or remove onecode skills. Skills are "
@@ -665,7 +670,13 @@ def session(action, session_id):
             if session_id is None:
                 click.echo("Usage: cdh session load <id>")
                 return
-            s = await db.session_get(session_id)
+            s = None
+            try:
+                s = await db.session_get(int(session_id))
+            except (ValueError, TypeError):
+                pass
+            if s is None:
+                s = await db.session_get_by_agent_session_id(session_id)
             if s is None:
                 click.echo(f"Session {session_id} not found.")
                 return

package/cdh/scaffold.py

@@ -1,8 +1,7 @@
 from __future__ import annotations
 
-from dataclasses import dataclass, field
+from dataclasses import dataclass
 from pathlib import Path
-from typing import Optional
 
 import yaml
 
@@ -102,40 +101,40 @@ COMPONENT_BY_ID: dict[str, ComponentSpec] = {c.id: c for c in COMPONENTS}
 CROSS_CUTTING: tuple[CrossCutSpec, ...] = (
     CrossCutSpec(
         id="contracts",
-        paths=("contracts/api", "contracts/events", "contracts/CHANGELOG.md"),
+        paths=("aidlc/contracts/CHANGELOG.md",),
         label="Interface Contracts",
         description="API/event contracts and changelog",
     ),
     CrossCutSpec(
         id="shared",
-        paths=("packages/shared",),
+        paths=("aidlc/packages/shared",),
         label="Shared Types",
         description="Cross-component shared types package",
     ),
     CrossCutSpec(
         id="openspec",
-        paths=("openspec/changes",),
+        paths=(),
         label="OpenSpec Changes",
         description="OpenSpec change proposals",
     ),
     CrossCutSpec(
         id="cross_stack_features",
-        paths=("features/cross-stack",),
+        paths=(),
         label="Cross-Stack BDD",
         description="End-to-end BDD features across components",
     ),
     CrossCutSpec(
         id="cross_stack_tests",
-        paths=("tests/contract", "tests/cross-stack"),
+        paths=("aidlc/tests/contract", "aidlc/tests/cross-stack"),
         label="Cross-Stack Tests",
         description="Contract tests and cross-stack integration tests",
     ),
     CrossCutSpec(
         id="provider",
         paths=(
-            "providers/tcb/provider.yaml",
-            "providers/tcb/deployment.yaml",
-            "providers/tcb/preview.yaml",
+            "aidlc/providers/tcb/provider.yaml",
+            "aidlc/providers/tcb/deployment.yaml",
+            "aidlc/providers/tcb/preview.yaml",
         ),
         label="Cloud Provider",
         description="TCB (Tencent CloudBase) provider config",
@@ -143,9 +142,9 @@ CROSS_CUTTING: tuple[CrossCutSpec, ...] = (
     CrossCutSpec(
         id="tools",
         paths=(
-            "tools/deploy_stack.py",
-            "tools/contract_diff.py",
-            "tools/generate_shared.py",
+            "aidlc/tools/deploy_stack.py",
+            "aidlc/tools/contract_diff.py",
+            "aidlc/tools/generate_shared.py",
         ),
         label="Tooling Scripts",
         description="deploy_stack / contract_diff / generate_shared stubs",
@@ -238,6 +237,95 @@ Thumbs.db
 
 CHANGELOG_MD = "# Changelog\n\n## [0.1.0] - Initial scaffold\n\n- Project created via cdh scaffold\n"
 
+AGENTS_MD_TEMPLATE = """# AGENTS.md — Project Constitution
+
+Hard rules every AI agent must follow when working in this repo.
+Read once per session; behavior is enforced by the agent runtime.
+
+## Project Overview
+
+- **Name**: {project_name}
+- **Description**: {description}
+- **Type**: monorepo — AI-DLC multi-component stack
+{component_list}
+
+## AI-DLC Core Cycle
+
+```
+① 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
+```
+
+Reference skill: `~/.cdh/skills/ai-dlc-skill/SKILL.md` (full AI-DLC methodology; installed by cdh platform bootstrap).
+
+## Component Mapping
+
+Work is partitioned by component prefix. Place new code in the matching directory:
+
+| Prefix | Component | Directory |
+|--------|-----------|-----------|
+{component_table}
+
+> **Note**: FR namespaces are used in AI-DLC lifecycle only.
+
+## Quality Gates
+
+Hard thresholds every agent must respect:
+
+| Gate | Threshold |
+|------|-----------|
+| Unit/integration coverage | >= 80% |
+| BDD scenarios pass | 100% |
+| Contract tests pass | 100% |
+| Cross-stack e2e pass | 100% |
+| Security vulns | 0 |
+
+## File / Path Hygiene
+
+**Never read, write, or modify** any of these (they're local-only / secrets / build artifacts):
+
+- `.cdh/` — project-level runtime state (managed by CLI; never hand-edit)
+- `.opencode/`, `.claude/`, `.agents/` — tool configs (owned by user)
+- `.qwen/`, `.idea/` — IDE / tool caches
+- `dist/`, `*.egg-info/`, `__pycache__/`, `build/`, `.venv/`
+- `node_modules/`, `.next/`, `.nuxt/`
+- `.python-version`, `uv.lock` — Python toolchain pinning (user-managed)
+- `aidlc/contracts/CHANGELOG.md` — contract changelog (managed by CLI)
+- `aidlc/providers/` — provider config (managed by CLI)
+
+**Global state directories** (managed at runtime, do not hand-edit):
+- `~/.cdh/` — cdh platform global state (projects/, skills/, mcps/, state/, logs/, sessions/)
+- `~/.onecode/` — onecode engine private state (traces, memory, mcps, skills, config)
+
+## Forbidden Actions
+
+- Commit secrets (API keys, tokens, passwords) — use env vars or vault
+- Force-push to `main` / `master`
+- Modify files outside the project root
+- Run `npm publish` / `pip upload` without explicit user approval
+- Hand-edit `.cdh/state.json`, `.cdh/todos.json`, `.cdh/last_session.json` — use CLI / slash commands
+- Delete tracked files outside `dist/`, `build/`, `__pycache__/` without confirmation
+
+## Working Conventions
+
+This project follows the **AI-DLC (AI-Driven Lifecycle)** methodology shown above.
+
+- **Plan first**: Use task management (TodoCreate) for any non-trivial task (3+ steps)
+- **Route execution**:
+  - Single-step (1 tool, 1 file) → direct tool call
+  - Multi-step / multi-file / research → delegate to sub-agent
+- **Language**: Chinese for explanations to user, English for code / comments / commit messages
+- **Verification**: After non-trivial edits, run applicable lint/typecheck/test commands before declaring done
+
+## Where to Find More
+
+- **AI-DLC methodology**: `~/.cdh/skills/ai-dlc-skill/SKILL.md` (load via Skill tool; installed by cdh bootstrap)
+- **Human-readable README**: `README.md`
+- **Architecture / practices**: `docs/` if present, or ask the user
+"""
+
 REQUIREMENTS_MD = """# {project_name}
 
 ## Intent
@@ -267,9 +355,8 @@ Default cloud provider: TCB (Tencent CloudBase).
 
 
 def _detect_dlc_skill(workspace_root: Path) -> bool:
-    from onecode.skills.loader import SkillLoader
-    loader = SkillLoader(workspace_root)
-    return loader.get(SKILL_NAME) is not None
+    from cdh.cdh_skill_manager import CDH_PLATFORM_SKILLS_DIR
+    return (CDH_PLATFORM_SKILLS_DIR / SKILL_NAME / "SKILL.md").exists()
 
 
 def _mkdir(path: Path) -> None:
@@ -287,6 +374,37 @@ def _write(path: Path, content: str) -> None:
     path.write_text(content.lstrip("\n"), encoding="utf-8")
 
 
+def _build_agents_component_list(active: list[ComponentSpec]) -> str:
+    if not active:
+        return ""
+    items = (f"  - **{c.label}** (`{c.owns}`)" for c in active)
+    return "- **Components**:\n" + "\n".join(items)
+
+
+def _build_agents_component_table(active: list[ComponentSpec]) -> str:
+    rows = []
+    for c in active:
+        rows.append(f"| {c.fr_prefix:7s} | {c.label:14s} | {c.owns:20s} |")
+    rows.append("| INT      | Contracts, Shared | aidlc/contracts/, aidlc/packages/shared/ |")
+    return "\n".join(rows)
+
+
+def _write_agents_and_claude_md(
+    root: Path,
+    project_name: str,
+    description: str,
+    active: list[ComponentSpec],
+) -> None:
+    content = AGENTS_MD_TEMPLATE.format(
+        project_name=project_name,
+        description=description or f"AI-DLC monorepo project: {project_name}",
+        component_list=_build_agents_component_list(active),
+        component_table=_build_agents_component_table(active),
+    )
+    _write(root / "AGENTS.md", content)
+    _write(root / "CLAUDE.md", content)
+
+
 def _component_to_dict(c: ComponentSpec) -> dict:
     out = {
         "id": c.id,
@@ -298,19 +416,27 @@ def _component_to_dict(c: ComponentSpec) -> dict:
     return out
 
 
-def _build_project_yaml(active: list[ComponentSpec], cross_cutting_ids: list[str]) -> dict:
+def _build_project_yaml(
+    active: list[ComponentSpec],
+    cross_cutting_ids: list[str],
+    name: str = "",
+    description: str = "",
+) -> dict:
     cross_cutting: dict = {"fr_prefix": "INT"}
     if "contracts" in cross_cutting_ids:
-        cross_cutting["contracts"] = "contracts/"
+        cross_cutting["contracts"] = "aidlc/contracts/"
     if "shared" in cross_cutting_ids:
-        cross_cutting["shared_types"] = "packages/shared/"
-    return {
+        cross_cutting["shared_types"] = "aidlc/packages/shared/"
+    doc: dict = {
+        "name": name,
+        "description": description,
         "stack": {
             "topology": "monorepo",
             "components": [_component_to_dict(c) for c in active],
             "cross_cutting": cross_cutting,
-        }
+        },
     }
+    return doc
 
 
 def _build_component_table(active: list[ComponentSpec]) -> str:
@@ -343,15 +469,15 @@ def _scaffold_cross_cutting(cross_ids: list[str], root: Path) -> None:
         for p in spec.paths:
             target = root / p
             if p.endswith((".yaml", ".py", ".md")):
-                if p == "contracts/CHANGELOG.md":
+                if p == "aidlc/contracts/CHANGELOG.md":
                     _write(target, CHANGELOG_MD)
-                elif p == "providers/tcb/provider.yaml":
+                elif p == "aidlc/providers/tcb/provider.yaml":
                     _write(target, TCB_PROVIDER_YAML)
-                elif p == "providers/tcb/deployment.yaml":
+                elif p == "aidlc/providers/tcb/deployment.yaml":
                     _write(target, TCB_DEPLOYMENT_YAML)
-                elif p == "providers/tcb/preview.yaml":
+                elif p == "aidlc/providers/tcb/preview.yaml":
                     _write(target, TCB_PREVIEW_YAML)
-                elif p.startswith("tools/") and p.endswith(".py"):
+                elif p.startswith("aidlc/tools/") and p.endswith(".py"):
                     _write(target, TOOL_STUB)
                     target.chmod(0o755)
                 else:
@@ -369,11 +495,14 @@ def _write_project_yaml(
     description: str,
 ) -> None:
     _write(
-        root / "project.yaml",
-        yaml.dump(_build_project_yaml(active, cross_cutting_ids), default_flow_style=False),
+        root / "aidlc" / "project.yaml",
+        yaml.dump(
+            _build_project_yaml(active, cross_cutting_ids, name=project_name, description=description),
+            default_flow_style=False,
+        ),
     )
     _write(
-        root / "requirements.md",
+        root / "aidlc" / "requirements.md",
         REQUIREMENTS_MD.format(
             project_name=project_name,
             description=description or f"AI-DLC monorepo project: {project_name}",
@@ -381,7 +510,7 @@ def _write_project_yaml(
         ),
     )
     _write(root / ".gitignore", GITIGNORE_CONTENT)
-    _write(root / "CHANGELOG.md", CHANGELOG_MD)
+    _write(root / "aidlc" / "CHANGELOG.md", CHANGELOG_MD)
 
 
 def init_dlc_project(
@@ -391,15 +520,15 @@ def init_dlc_project(
 ) -> bool:
     """Scaffold project metadata only (no apps/*, no cross-cutting dirs).
 
-    Writes project.yaml (with empty components list), requirements.md,
-    .gitignore, and CHANGELOG.md. The user is expected to add components
+    Writes project.yaml (with empty components list), aidlc/requirements.md,
+    .gitignore, and aidlc/CHANGELOG.md. The user is expected to add components
     and cross-cutting items later via add_component / add_cross_cutting.
 
     Returns True if scaffolding was performed.
 
     Raises RuntimeError if ai-dlc-skill is not available — the directory
     is left untouched in that case so callers don't end up with a
-    half-initialized project (.cdh/ written but no project.yaml).
+    half-initialized project (.cdh/ written but no aidlc/project.yaml).
     """
     if not _detect_dlc_skill(workspace_root):
         raise RuntimeError(
@@ -415,6 +544,7 @@ def init_dlc_project(
         cross_cutting_ids=[],
         description=description,
     )
+    _write_agents_and_claude_md(root, project_name, description, [])
     return True
 
 
@@ -457,7 +587,9 @@ def scaffold_dlc_project(
 
     root = workspace_root.resolve()
     active = [COMPONENT_BY_ID[cid] for cid in components]
-    all_cross_ids = [c.id for c in CROSS_CUTTING]
+    all_cross_ids = [
+        c.id for c in CROSS_CUTTING if c.id not in ("provider", "tools")
+    ]
 
     _write_project_yaml(
         root=root,
@@ -471,10 +603,27 @@ def scaffold_dlc_project(
         _scaffold_component(c, root)
 
     _scaffold_cross_cutting(all_cross_ids, root)
+    _write_agents_and_claude_md(root, project_name, description, active)
 
     return True
 
 
+def _regenerate_agents_and_claude_md(root: Path) -> None:
+    project_yaml = root / "aidlc" / "project.yaml"
+    if not project_yaml.exists():
+        return
+    data = yaml.safe_load(project_yaml.read_text(encoding="utf-8")) or {}
+    name = data.get("name", root.name)
+    description = data.get("description", "")
+    components = data.get("stack", {}).get("components", []) or []
+    active = []
+    for c in components:
+        spec = COMPONENT_BY_ID.get(c.get("id", ""))
+        if spec:
+            active.append(spec)
+    _write_agents_and_claude_md(root, name, description, active)
+
+
 def add_component(
     workspace_root: Path,
     component_id: str,
@@ -482,7 +631,7 @@ def add_component(
     """Add a single application component to an existing project.
 
     Creates apps/<owns>/{src,tests/unit,tests/e2e,features} with
-    .gitkeep files and updates project.yaml's stack.components list.
+    .gitkeep files and updates aidlc/project.yaml's stack.components list.
 
     Returns True if the component was added, False if it was already
     present. Raises ValueError on unknown component id.
@@ -495,10 +644,10 @@ def add_component(
         )
 
     root = workspace_root.resolve()
-    project_yaml = root / "project.yaml"
+    project_yaml = root / "aidlc" / "project.yaml"
     if not project_yaml.exists():
         raise FileNotFoundError(
-            f"project.yaml not found at {root}. Run 'cdh project init' first."
+            f"aidlc/project.yaml not found at {root}. Run 'cdh project init' first."
         )
 
     data = yaml.safe_load(project_yaml.read_text(encoding="utf-8")) or {}
@@ -514,6 +663,7 @@ def add_component(
         yaml.dump(data, default_flow_style=False),
         encoding="utf-8",
     )
+    _regenerate_agents_and_claude_md(root)
     return True
 
 
@@ -523,7 +673,7 @@ def add_cross_cutting(
 ) -> bool:
     """Add a single cross-cutting item to an existing project.
 
-    Creates the relevant directories/files and updates project.yaml
+    Creates the relevant directories/files and updates aidlc/project.yaml
     so that stack.cross_cutting references the new path.
 
     Returns True if the item was added, False if it was already present.
@@ -537,10 +687,10 @@ def add_cross_cutting(
         )
 
     root = workspace_root.resolve()
-    project_yaml = root / "project.yaml"
+    project_yaml = root / "aidlc" / "project.yaml"
     if not project_yaml.exists():
         raise FileNotFoundError(
-            f"project.yaml not found at {root}. Run 'cdh project init' first."
+            f"aidlc/project.yaml not found at {root}. Run 'cdh project init' first."
         )
 
     cross_paths = [root / p for p in spec.paths]
@@ -552,7 +702,7 @@ def add_cross_cutting(
     data = yaml.safe_load(project_yaml.read_text(encoding="utf-8")) or {}
     cross_cutting = data.setdefault("stack", {}).setdefault("cross_cutting", {})
     if cross_id == "contracts":
-        cross_cutting["contracts"] = "contracts/"
+        cross_cutting["contracts"] = "aidlc/contracts/"
     elif cross_id == "shared":
         cross_cutting["shared_types"] = "packages/shared/"
 
@@ -560,6 +710,7 @@ def add_cross_cutting(
         yaml.dump(data, default_flow_style=False),
         encoding="utf-8",
     )
+    _regenerate_agents_and_claude_md(root)
     return True
 
 

package/onecode/__init__.py

@@ -1 +1 @@
-__version__ = "1.0.0"
+__version__ = "1.0.5"