aes-cli 0.4.2__tar.gz → 0.5.0__tar.gz

{aes_cli-0.4.2 → aes_cli-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aes-cli
-Version: 0.4.2
+Version: 0.5.0
 Summary: CLI tool for the Agentic Engineering Standard
 Author: Hiro
 License: Apache-2.0
@@ -46,6 +46,15 @@ pipx install aes-cli
 pip install aes-cli
 ```
 
+### Upgrading
+
+```bash
+pipx upgrade aes-cli            # if installed with pipx
+pip install --upgrade aes-cli   # if installed with pip
+```
+
+After upgrading, run `aes sync` in your project to regenerate tool-specific configs with the new version's sync logic. Your `.agent/` source files are not modified by the upgrade.
+
 Requires Python 3.10+.
 
 ## Quick Start

{aes_cli-0.4.2 → aes_cli-0.5.0}/README.md

@@ -13,6 +13,15 @@ pipx install aes-cli
 pip install aes-cli
 ```
 
+### Upgrading
+
+```bash
+pipx upgrade aes-cli            # if installed with pipx
+pip install --upgrade aes-cli   # if installed with pip
+```
+
+After upgrading, run `aes sync` in your project to regenerate tool-specific configs with the new version's sync logic. Your `.agent/` source files are not modified by the upgrade.
+
 Requires Python 3.10+.
 
 ## Quick Start

{aes_cli-0.4.2 → aes_cli-0.5.0}/aes/__init__.py

@@ -2,4 +2,4 @@
 
 from __future__ import annotations
 
-__version__ = "0.4.2"
+__version__ = "0.5.0"

{aes_cli-0.4.2 → aes_cli-0.5.0}/aes/commands/init.py

@@ -427,6 +427,7 @@ def _print_post_init_summary(
 
     cmd_branch = tree.add("commands/")
     cmd_branch.add("setup.md")
+    cmd_branch.add("memory.md [dim]/memory[/]")
     if isinstance(domain_config, DomainConfig) and domain_config.workflow_commands:
         for cmd_def in domain_config.workflow_commands:
             cmd_branch.add(f"{cmd_def.id}.md [dim]{cmd_def.trigger}[/]")
@@ -702,10 +703,12 @@ def init_cmd(
     memory_content = f"# {name} — Agent Memory\n\n## Project Overview\n\n## Architecture\n\n## Status\n\n## Key Patterns\n"
     (agent_dir / MEMORY_DIR / "project.md").write_text(memory_content)
 
-    # Commands directory + /setup runbook
+    # Commands directory + /setup and /memory runbooks
     (agent_dir / COMMANDS_DIR).mkdir(exist_ok=True)
     content = _render_template(env, "setup.md.jinja", context)
     (agent_dir / COMMANDS_DIR / "setup.md").write_text(content)
+    content = _render_template(env, "memory_command.md.jinja", context)
+    (agent_dir / COMMANDS_DIR / "memory.md").write_text(content)
 
     # Workflow command runbooks
     if domain_config and domain_config.workflow_commands:

{aes_cli-0.4.2 → aes_cli-0.5.0}/aes/frameworks.py

@@ -18,7 +18,7 @@ from copy import deepcopy
 from dataclasses import dataclass, field
 from typing import Dict, List, Optional
 
-from aes.domains import DomainConfig, SkillDef, WorkflowDef, WorkflowStateDef, WorkflowTransitionDef
+from aes.domains import CommandDef, DomainConfig, SkillDef, WorkflowDef, WorkflowStateDef, WorkflowTransitionDef, _BUILD_COMMAND
 
 
 # ---------------------------------------------------------------------------
@@ -125,6 +125,7 @@ _API_WORKFLOW = WorkflowDef(
 )
 
 API_CONFIG = DomainConfig(
+    workflow_commands=[_BUILD_COMMAND],
     instructions_description="API service with endpoints, authentication, and database.",
     instructions_quick_ref="",  # filled by framework overlay
     instructions_project_structure="",  # generic, filled by overlay or /setup
@@ -177,6 +178,7 @@ _FRONTEND_WORKFLOW = WorkflowDef(
 )
 
 FRONTEND_CONFIG = DomainConfig(
+    workflow_commands=[_BUILD_COMMAND],
     instructions_description="Frontend application with components, routing, and state management.",
     instructions_rules=[
         "**Component-first** -- build small, reusable components.",
@@ -202,6 +204,7 @@ FRONTEND_CONFIG = DomainConfig(
 )
 
 FULLSTACK_CONFIG = DomainConfig(
+    workflow_commands=[_BUILD_COMMAND],
     instructions_description="Full-stack application with frontend, API, and database.",
     instructions_rules=[
         "**Type safety everywhere** -- shared types between frontend and API.",
@@ -227,6 +230,7 @@ FULLSTACK_CONFIG = DomainConfig(
 )
 
 CLI_CONFIG = DomainConfig(
+    workflow_commands=[_BUILD_COMMAND],
     instructions_description="Command-line tool with subcommands, argument parsing, and user interaction.",
     instructions_rules=[
         "**Clear error messages** -- users see stderr, make it helpful.",
@@ -251,6 +255,7 @@ CLI_CONFIG = DomainConfig(
 )
 
 LIBRARY_CONFIG = DomainConfig(
+    workflow_commands=[_BUILD_COMMAND],
     instructions_description="Reusable library or package for other projects to consume.",
     instructions_rules=[
         "**Public API is a contract** -- don't break it without a major version bump.",

{aes_cli-0.4.2 → aes_cli-0.5.0}/aes/scaffold/agent.yaml.jinja

@@ -1,6 +1,6 @@
 {% if domain_config %}
 # .agent/agent.yaml — AES Manifest
-aes: "1.0"
+aes: "1.1"
 
 name: "{{ name }}"
 version: "0.1.0"
@@ -41,6 +41,10 @@ commands:
     path: "commands/setup.md"
     trigger: "/setup"
     description: "Review and customize .agent/ files for your project"
+  - id: "memory"
+    path: "commands/memory.md"
+    trigger: "/memory"
+    description: "Review conversation and save learnings to agent memory"
 {% if domain_config.workflow_commands %}
 {% for cmd in domain_config.workflow_commands %}
   - id: "{{ cmd.id }}"
@@ -72,7 +76,7 @@ environment:
 {% endif %}
 {% else %}
 # .agent/agent.yaml — AES Manifest
-aes: "1.0"
+aes: "1.1"
 
 name: "{{ name }}"
 version: "0.1.0"
@@ -116,6 +120,10 @@ commands:
     path: "commands/setup.md"
     trigger: "/setup"
     description: "Populate .agent/ files by analyzing the codebase"
+  - id: "memory"
+    path: "commands/memory.md"
+    trigger: "/memory"
+    description: "Review conversation and save learnings to agent memory"
   # - id: "run"
   #   path: "commands/run.md"
   #   trigger: "/run"

{aes_cli-0.4.2 → aes_cli-0.5.0}/aes/scaffold/instructions.md.jinja

@@ -51,7 +51,7 @@ When creating or editing `.agent/` files, follow these formats exactly.
 ### Skill manifest (`.skill.yaml`)
 
 ```yaml
-aes_skill: "1.0"
+aes_skill: "1.1"
 
 id: "my-skill"
 name: "My Skill"
@@ -100,7 +100,7 @@ tags:
 ### Workflow (`.yaml`)
 
 ```yaml
-aes_workflow: "1.0"
+aes_workflow: "1.1"
 
 id: "my-workflow"
 entity: "item"
@@ -226,7 +226,7 @@ When creating or editing `.agent/` files, follow these formats exactly.
 ### Skill manifest (`.skill.yaml`)
 
 ```yaml
-aes_skill: "1.0"
+aes_skill: "1.1"
 
 id: "my-skill"
 name: "My Skill"
@@ -275,7 +275,7 @@ tags:
 ### Workflow (`.yaml`)
 
 ```yaml
-aes_workflow: "1.0"
+aes_workflow: "1.1"
 
 id: "my-workflow"
 entity: "item"

aes_cli-0.5.0/aes/scaffold/ja/memory_command.md.jinja

@@ -0,0 +1,99 @@
+# コマンド: /memory
+
+現在の会話をレビューし、記憶に値するアイテムを `.agent/memory/` に保存します。
+
+## 実行タイミング
+
+- **手動**: `/memory` を実行して重要な学びを保存
+- **自動トリガー**: 重要な作業セッションの終了時に実行 — コマンド完了後、アーキテクチャの意思決定後、困難なバグの解決後、大規模な実装作業の完了後
+
+## フェーズ 1: コンテキストのレビュー
+
+会話をスキャンし、保存する価値のあるアイテムを特定:
+
+1. **アーキテクチャの決定** — 新しいパターン、技術選択、根拠を伴うデザインのトレードオフ
+2. **苦労して得た解決策** — 診断に労力を要したバグ、非自明な修正、ワークアラウンド
+3. **プロジェクトの規約** — 複数のインタラクションで確認されたパターン
+4. **環境/インフラのメモ** — デプロイの詳細、ランタイムの癖、認証情報の設定
+5. **ステータスの変更** — 構築されたもの、進行中に移行したもの、計画されたもの
+
+**無視するもの:**
+- 一時的な状態（現在のタスクの詳細、進行中の作業の詳細）
+- セッション間で未確認の単一観察による結論
+- `.agent/instructions.md` に既に記載されている情報
+- セッション固有の詳細（一時ファイルパス、エフェメラルID）
+
+## フェーズ 2: 既存メモリの確認
+
+重複を避けるために、現在のメモリファイルを読む:
+
+1. `.agent/memory/project.md` — 全セクションを確認
+2. `.agent/memory/learnings.yaml` — 既存の学習IDを確認
+
+各候補アイテムについて:
+- 既存エントリを**更新**する場合 → 既存エントリをその場で修正
+- 既存エントリと**矛盾**する場合 → 新しい理解で置き換え
+- **真に新しい**場合 → 適切なセクションに追加
+- 既存エントリと**重複**する場合 → スキップ
+
+## フェーズ 3: プロジェクトメモリへの保存
+
+`.agent/memory/project.md` を以下のセクションに該当するアイテムで更新:
+
+| セクション | 記載内容 |
+|-----------|---------|
+| **プロジェクト概要** | システム目的の変更、スコープの変更 |
+| **アーキテクチャ** | 根拠を伴う新しい技術的決定 |
+| **ステータス** | 構築済み、進行中、計画中のもの |
+| **主要パターン** | コードベースから確認されたパターン |
+| **環境メモ** | デプロイ、ランタイム、インフラの詳細 |
+
+`project.md` を200行以下に維持してください。制限に近づいた場合は、超過するのではなく、古いエントリを統合または削除してください。
+
+## フェーズ 4: 構造化された学習の保存
+
+明確な適用性を持つ苦労して得た教訓について、`.agent/memory/learnings.yaml` に追加:
+
+```yaml
+- id: "ケバブケースid"
+  date: "YYYY-MM-DD"
+  context: "何が起きていたか"
+  observation: "何が観察されたか"
+  lesson: "一般化された教訓"
+  applies_when:
+    - "条件 1"
+    - "条件 2"
+  action: "これが適用される場合に何をするか"
+```
+
+構造化された学習は以下の場合にのみ作成:
+- 複数の観察で確認された、または
+- 発見に大きな労力を要した、または
+- 忘れると実害が生じる
+
+## フェーズ 5: セッションスナップショット
+
+セッションが実質的な作業を含んでいた場合、`.agent/memory/sessions/YYYY-MM-DD.md` を作成:
+
+```markdown
+# セッション: YYYY-MM-DD
+
+## 実施内容
+- ...
+
+## 行われた決定
+- ...
+
+## 未解決の質問
+- ...
+```
+
+軽微なセッション（クイックフィックス、小さな設定変更）ではこのフェーズをスキップしてください。
+
+## フェーズ 6: 報告
+
+保存されたものを要約:
+- `project.md` に追加または更新されたアイテム
+- `learnings.yaml` に追加された学習（ある場合）
+- 作成されたセッションファイル（ある場合）
+- 重複としてスキップされたアイテム

aes_cli-0.5.0/aes/scaffold/memory_command.md.jinja

@@ -0,0 +1,99 @@
+# Command: /memory
+
+Review the current conversation and save memory-worthy items to `.agent/memory/`.
+
+## When to Run
+
+- **Manually**: Run `/memory` at any point to persist important learnings
+- **Auto-trigger**: Run this at the end of significant work sessions — after completing commands, making architectural decisions, solving difficult bugs, or finishing substantial implementation work
+
+## Phase 1: Review Context
+
+Scan the conversation and identify items worth persisting:
+
+1. **Architectural decisions** — new patterns, technology choices, design trade-offs with rationale
+2. **Hard-won solutions** — bugs that took effort to diagnose, non-obvious fixes, workarounds
+3. **Project conventions** — patterns confirmed across multiple interactions
+4. **Environment/infra notes** — deployment details, runtime quirks, credentials setup
+5. **Status changes** — what was built, what shifted to in-progress or planned
+
+**Ignore:**
+- Temporary state (current task details, in-progress work details)
+- Single-observation conclusions not yet confirmed across sessions
+- Information already captured in `.agent/instructions.md`
+- Session-specific details (temp file paths, ephemeral IDs)
+
+## Phase 2: Check Existing Memory
+
+Read the current memory files to avoid duplicates:
+
+1. `.agent/memory/project.md` — check all sections
+2. `.agent/memory/learnings.yaml` — check existing learning IDs
+
+For each candidate item:
+- **Updates** an existing entry → modify the existing entry in place
+- **Contradicts** an existing entry → replace with the newer understanding
+- **Genuinely new** → append to the appropriate section
+- **Duplicates** an existing entry → skip
+
+## Phase 3: Save to Project Memory
+
+Update `.agent/memory/project.md` with items that belong in these sections:
+
+| Section | What goes here |
+|---------|---------------|
+| **Project Overview** | System purpose changes, scope shifts |
+| **Architecture** | New technical decisions with rationale |
+| **Status** | What's built, in progress, planned |
+| **Key Patterns** | Confirmed patterns from the codebase |
+| **Environment Notes** | Deployment, runtime, infrastructure details |
+
+Keep `project.md` under 200 lines. If approaching the limit, consolidate or remove outdated entries rather than exceeding it.
+
+## Phase 4: Save Structured Learnings
+
+For hard-won lessons with clear applicability, append to `.agent/memory/learnings.yaml`:
+
+```yaml
+- id: "kebab-case-id"
+  date: "YYYY-MM-DD"
+  context: "what was happening"
+  observation: "what was observed"
+  lesson: "generalized takeaway"
+  applies_when:
+    - "condition 1"
+    - "condition 2"
+  action: "what to do when this applies"
+```
+
+Only create structured learnings for insights that:
+- Were confirmed across multiple observations, OR
+- Required significant effort to discover, OR
+- Would cause real damage if forgotten
+
+## Phase 5: Session Snapshot
+
+If the session involved substantial work, create `.agent/memory/sessions/YYYY-MM-DD.md`:
+
+```markdown
+# Session: YYYY-MM-DD
+
+## What Was Done
+- ...
+
+## Decisions Made
+- ...
+
+## Open Questions
+- ...
+```
+
+Skip this phase for minor sessions (quick fixes, small config changes).
+
+## Phase 6: Report
+
+Summarize what was persisted:
+- Items added or updated in `project.md`
+- Learnings added to `learnings.yaml` (if any)
+- Session file created (if any)
+- Items skipped as duplicates

{aes_cli-0.4.2 → aes_cli-0.5.0}/aes/scaffold/permissions.yaml.jinja

@@ -1,6 +1,6 @@
 {% if domain_config %}
 # .agent/permissions.yaml — Agent Capability Boundaries
-aes_permissions: "1.0"
+aes_permissions: "1.1"
 
 allow:
   shell:
@@ -82,7 +82,7 @@ resource_limits:
 {% endif %}
 {% else %}
 # .agent/permissions.yaml — Agent Capability Boundaries
-aes_permissions: "1.0"
+aes_permissions: "1.1"
 
 allow:
   shell:

{aes_cli-0.4.2 → aes_cli-0.5.0}/aes/scaffold/skill.yaml.jinja

@@ -1,6 +1,6 @@
 {% if skill %}
 # .agent/skills/{{ skill.id }}.skill.yaml
-aes_skill: "1.0"
+aes_skill: "1.1"
 
 id: "{{ skill.id }}"
 name: "{{ skill.name }}"
@@ -107,7 +107,7 @@ tags:
 {% endfor %}
 {% else %}
 # .agent/skills/{{ skill_id }}.skill.yaml
-aes_skill: "1.0"
+aes_skill: "1.1"
 
 id: "{{ skill_id }}"
 name: "{{ skill_name }}"

{aes_cli-0.4.2 → aes_cli-0.5.0}/aes/scaffold/workflow.yaml.jinja

@@ -1,4 +1,4 @@
-aes_workflow: "1.0"
+aes_workflow: "1.1"
 
 id: "{{ workflow.id }}"
 entity: "{{ workflow.entity }}"

{aes_cli-0.4.2 → aes_cli-0.5.0}/aes/targets/claude.py

@@ -51,6 +51,15 @@ class ClaudeTarget(SyncTarget):
             if confirm_section:
                 content += "\n" + confirm_section
 
+        # Memory management instruction (auto-trigger /memory)
+        content += (
+            "\n## Memory Management\n\n"
+            "At the end of significant work sessions \u2014 especially after "
+            "completing commands, making architectural decisions, or solving "
+            "difficult bugs \u2014 run `/memory` to persist learnings to "
+            "`.agent/memory/`.\n"
+        )
+
         action = self._check_conflict(ctx.project_root, "CLAUDE.md", force)
         plan.files.append(GeneratedFile(
             relative_path="CLAUDE.md",

{aes_cli-0.4.2 → aes_cli-0.5.0}/aes_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aes-cli
-Version: 0.4.2
+Version: 0.5.0
 Summary: CLI tool for the Agentic Engineering Standard
 Author: Hiro
 License: Apache-2.0
@@ -46,6 +46,15 @@ pipx install aes-cli
 pip install aes-cli
 ```
 
+### Upgrading
+
+```bash
+pipx upgrade aes-cli            # if installed with pipx
+pip install --upgrade aes-cli   # if installed with pip
+```
+
+After upgrading, run `aes sync` in your project to regenerate tool-specific configs with the new version's sync logic. Your `.agent/` source files are not modified by the upgrade.
+
 Requires Python 3.10+.
 
 ## Quick Start

{aes_cli-0.4.2 → aes_cli-0.5.0}/aes_cli.egg-info/SOURCES.txt

@@ -28,6 +28,7 @@ aes/scaffold/agentignore.jinja
 aes/scaffold/instructions.md.jinja
 aes/scaffold/local.example.yaml.jinja
 aes/scaffold/local.yaml.jinja
+aes/scaffold/memory_command.md.jinja
 aes/scaffold/operations.md.jinja
 aes/scaffold/orchestrator.md.jinja
 aes/scaffold/permissions.yaml.jinja
@@ -37,6 +38,7 @@ aes/scaffold/skill.yaml.jinja
 aes/scaffold/workflow.yaml.jinja
 aes/scaffold/workflow_command.md.jinja
 aes/scaffold/ja/instructions.md.jinja
+aes/scaffold/ja/memory_command.md.jinja
 aes/scaffold/ja/operations.md.jinja
 aes/scaffold/ja/orchestrator.md.jinja
 aes/scaffold/ja/setup.md.jinja

{aes_cli-0.4.2 → aes_cli-0.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "aes-cli"
-version = "0.4.2"
+version = "0.5.0"
 description = "CLI tool for the Agentic Engineering Standard"
 readme = "README.md"
 license = {text = "Apache-2.0"}

{aes_cli-0.4.2 → aes_cli-0.5.0}/tests/test_init.py

@@ -61,7 +61,7 @@ class TestInit:
         agent_yaml = tmp_path / ".agent" / "agent.yaml"
         with open(agent_yaml) as f:
             data = yaml.safe_load(f)
-        assert data["aes"] == "1.0"
+        assert data["aes"] == "1.1"
         assert data["name"] == "test-project"
         assert data["domain"] == "ml"
 
@@ -321,12 +321,21 @@ class TestWorkflowCommands:
         with open(tmp_path / ".agent" / "agent.yaml") as f:
             data = yaml.safe_load(f)
         commands = data.get("commands", [])
-        # Filter to workflow commands (exclude setup)
-        wf_cmds = [c for c in commands if c.get("id") != "setup"]
+        # Filter to workflow commands (exclude setup and memory)
+        wf_cmds = [c for c in commands if c.get("id") not in ("setup", "memory")]
         assert len(wf_cmds) >= 2
         assert wf_cmds[0]["id"] == "build"
         assert wf_cmds[0]["trigger"] == "/build"
 
+    def test_ml_memory_command(self, tmp_path):
+        """All domains get the /memory command."""
+        _init(tmp_path, name="test-ml", domain="ml")
+        cmd_path = tmp_path / ".agent" / "commands" / "memory.md"
+        assert cmd_path.exists()
+        content = cmd_path.read_text()
+        assert "/memory" in content
+        assert "Review" in content
+
     def test_web_build_command(self, tmp_path):
         _init(tmp_path, name="test-web", domain="web", language="typescript")
         cmd_path = tmp_path / ".agent" / "commands" / "build.md"
@@ -363,7 +372,7 @@ class TestWorkflowCommands:
         with open(tmp_path / ".agent" / "agent.yaml") as f:
             data = yaml.safe_load(f)
         commands = data.get("commands", [])
-        wf_cmds = [c for c in commands if c.get("id") != "setup"]
+        wf_cmds = [c for c in commands if c.get("id") not in ("setup", "memory")]
         assert len(wf_cmds) >= 2
         assert wf_cmds[0]["id"] == "build"
         assert wf_cmds[0]["trigger"] == "/build"
@@ -380,9 +389,9 @@ class TestWorkflowCommands:
     def test_other_domain_gets_build_command(self, tmp_path):
         _init(tmp_path, name="test-other", domain="other")
         commands_dir = tmp_path / ".agent" / "commands"
-        # Should get setup.md + build.md from DEV_ASSIST_BASE_CONFIG
+        # Should get setup.md + memory.md + build.md from DEV_ASSIST_BASE_CONFIG
         cmd_files = sorted(f.name for f in commands_dir.glob("*.md"))
-        assert cmd_files == ["build.md", "setup.md"]
+        assert cmd_files == ["build.md", "memory.md", "setup.md"]
 
     def test_explicit_domain_other_gets_build(self, tmp_path):
         """--domain other (explicit CLI, non-interactive) gets /build."""