| Dimension | Shared | Only in A | Only in B | Overlap |
|---|---|---|---|---|
| Sections | 0 | 1 | 3 | 0% |
| Commands | 0 | 0 | 5 | 0% |
| Section tags | 0 | 1 | 3 | 0% |
What each file covers
Sections
0 shared · 1 only in A · 3 only in B- − Agent V2 Frontend
- + AGENTS.md — difyctl (TypeScript CLI)
- + Architecture Boundaries
- + Commands
Commands
0 shared · 0 only in A · 5 only in B- + pnpm dev <command> [args...]
- + pnpm test
- + pnpm build
- + pnpm tree:gen
- + pnpm tree:check
Section tags
0 shared · 1 only in A · 3 only in B- − agent-behaviour
- + test
- + types
- + testing-strategy
Line diff
langgenius/dify · web/features/agent-v2/AGENTS.md
@@ −1 @@
1## Agent V2 Frontend
2
3- Keep Agent V2 separate from legacy workflow Agent. Use `web/features/agent-v2`, `web/app/components/workflow/nodes/agent-v2`, the `agent_node_kind: 'dify_agent'` and `version: '2'` payload discriminator, and `BlockEnum.AgentV2` where the graph type is already migrated. Do not bridge Agent V2 to legacy `agent_strategy_*` behavior or data shapes.
4
langgenius/dify · cli/AGENTS.md
@@ +1 @@
1# AGENTS.md — difyctl (TypeScript CLI)
2
3This package is the Node 22+, ESM TypeScript implementation of `difyctl`. Development also requires the Bun version pinned in `.bun-version`; command-tree generation and the `dev`, `test`, and `build` pre-scripts invoke it. Read [`ARD.md`] before adding a command or changing shared CLI infrastructure. Read `src/commands/AGENTS.md` for command-folder and registry rules.
4
5## Architecture Boundaries
6
7- Every leaf command extends `DifyCommand`; command classes own framework parsing and delegate behavior to domain modules.
8- Each command folder keeps its framework shell in `index.ts`. Extract behavior into sibling modules such as `run.ts` and `handlers.ts` when it needs an independently testable owner; those modules receive typed dependencies and do not import `src/framework/`.
9- `src/http/` owns ky middleware and client construction; `src/api/` owns resource clients; `src/sys/io/` owns process streams and progress UI; `src/types/` remains a pure data and schema leaf.
10- Preserve flags, output, and exit codes during refactors. Do not add dependencies or compatibility shims unless the task explicitly requires them.
11- `ARD.md` owns CLI code structure. Keep wire behavior aligned with typed API clients and the real mock-server behavior tests.
12
13## Commands
14
15Run package scripts from `cli/`:
16
17- Source CLI: `pnpm dev <command> [args...]`
18- Tests: `pnpm test`
19- Build: `pnpm build`
20- Regenerate and verify the registry: `pnpm tree:gen` and `pnpm tree:check`
21
22Run the scoped static check from the repository root with `vp check cli`.
23
24Behavior tests use the real Hono server under `test/fixtures/dify-mock/`; do not replace it with `nock`, `msw`, or `fetchMock`. Keep tests colocated with their source files.
25
26[`ARD.md`]: ARD.md
27
@@ −1 +1 @@
1−## Agent V2 Frontend
1+# AGENTS.md — difyctl (TypeScript CLI)
22
3−- Keep Agent V2 separate from legacy workflow Agent. Use `web/features/agent-v2`, `web/app/components/workflow/nodes/agent-v2`, the `agent_node_kind: 'dify_agent'` and `version: '2'` payload discriminator, and `BlockEnum.AgentV2` where the graph type is already migrated. Do not bridge Agent V2 to legacy `agent_strategy_*` behavior or data shapes.
3+This package is the Node 22+, ESM TypeScript implementation of `difyctl`. Development also requires the Bun version pinned in `.bun-version`; command-tree generation and the `dev`, `test`, and `build` pre-scripts invoke it. Read [`ARD.md`] before adding a command or changing shared CLI infrastructure. Read `src/commands/AGENTS.md` for command-folder and registry rules.
4+
5+## Architecture Boundaries
6+
7+- Every leaf command extends `DifyCommand`; command classes own framework parsing and delegate behavior to domain modules.
8+- Each command folder keeps its framework shell in `index.ts`. Extract behavior into sibling modules such as `run.ts` and `handlers.ts` when it needs an independently testable owner; those modules receive typed dependencies and do not import `src/framework/`.
9+- `src/http/` owns ky middleware and client construction; `src/api/` owns resource clients; `src/sys/io/` owns process streams and progress UI; `src/types/` remains a pure data and schema leaf.
10+- Preserve flags, output, and exit codes during refactors. Do not add dependencies or compatibility shims unless the task explicitly requires them.
11+- `ARD.md` owns CLI code structure. Keep wire behavior aligned with typed API clients and the real mock-server behavior tests.
12+
13+## Commands
14+
15+Run package scripts from `cli/`:
16+
17+- Source CLI: `pnpm dev <command> [args...]`
18+- Tests: `pnpm test`
19+- Build: `pnpm build`
20+- Regenerate and verify the registry: `pnpm tree:gen` and `pnpm tree:check`
21+
22+Run the scoped static check from the repository root with `vp check cli`.
23+
24+Behavior tests use the real Hono server under `test/fixtures/dify-mock/`; do not replace it with `nock`, `msw`, or `fetchMock`. Keep tests colocated with their source files.
25+
26+[`ARD.md`]: ARD.md
427
