graph-agents-cli 0.3.1__py3-none-any.whl

graph_agents_cli/scaffold/base_templates/python/{{cookiecutter.agent_guidance_filename}}

@@ -0,0 +1,35 @@
+process: {{ cookiecutter.process if cookiecutter.process else 'null' }}
+
+# Coding Agent Guide for {{cookiecutter.project_name}}
+
+This project was created by graph-agents-cli on the `{{cookiecutter.recorded_base_template}}` template.
+Agent code lives in `{{cookiecutter.agent_directory}}/`; the framework template that overlays this base
+replaces this file with its own guide. The rules below apply either way.
+
+## Governing process
+
+The `process:` line at the top names the process document that governs this
+project. When it is not `null`, follow that process's gates and approvals
+instead of the generic spec-before-code gate of the `graph-agents-cli-workflow`
+skill. When it is `null`, write `.graph-agents-cli-spec.md` and get it approved
+before writing code.
+
+## Rules
+
+- **Spec before code** unless the governing process says otherwise.
+- **Change only what was asked.** Preserve surrounding code, comments, config values and formatting.
+- **Never change the model** (`MODEL_PROVIDER`, `MODEL_NAME`) unless explicitly asked.
+- **Human approval before deploy.** Never run `graph-agents-cli deploy` without the user's explicit go-ahead.
+- **Run Python through uv**: `uv run python script.py`, after `uv sync`.
+- **Three strikes.** The same error three times means fix the cause, not retry.
+
+## Commands
+
+| Command | Purpose |
+|---|---|
+| `graph-agents-cli playground` | Run the app locally with reload |
+| `graph-agents-cli run "prompt"` | One-shot chat against the local or a deployed agent |
+| `uv run pytest tests/unit tests/integration` | Unit and integration tests |
+| `graph-agents-cli eval run` | Generate traces and grade them against the gate |
+| `graph-agents-cli lint` | Code quality and API-policy check |
+| `graph-agents-cli deploy --env <env>` | Deploy (only after the user approves) |

graph_agents_cli/scaffold/cmd_scaffold_group.py

@@ -0,0 +1,49 @@
+# Copyright 2026 Google LLC
+# Modifications Copyright 2026 graph-agents-cli contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""graph-agents-cli scaffold command group."""
+
+import click
+
+from graph_agents_cli._click import LazyGroup
+
+
+@click.group("scaffold", cls=LazyGroup)
+def scaffold_group():
+    """Scaffold, enhance, and upgrade agent projects.
+
+    \b
+    Subcommands:
+      create   Create a new agent project
+      enhance  Add or change the deployment target, CD mode, or runtime of a project
+      upgrade  Upgrade project to a newer graph-agents-cli version
+    """
+
+
+scaffold_group.add_lazy_command(
+    "create",
+    "graph_agents_cli.scaffold.commands.create:create",
+    "Create a LangGraph agent project from a template.",
+)
+scaffold_group.add_lazy_command(
+    "enhance",
+    "graph_agents_cli.scaffold.commands.enhance:enhance",
+    "Add or change the deployment target, CD mode, or runtime of an existing project.",
+)
+scaffold_group.add_lazy_command(
+    "upgrade",
+    "graph_agents_cli.scaffold.commands.upgrade:upgrade",
+    "Upgrade project to a newer graph-agents-cli version.",
+)

graph_agents_cli/scaffold/commands/__init__.py

@@ -0,0 +1,13 @@
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.