guild-cli 0.10.4__tar.gz → 0.11.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (109) hide show
  1. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/guild/scripts/configure-repo.sh +26 -4
  2. {guild_cli-0.10.4 → guild_cli-0.11.0}/CHANGELOG.md +32 -0
  3. {guild_cli-0.10.4 → guild_cli-0.11.0}/CLAUDE.md +1 -1
  4. {guild_cli-0.10.4 → guild_cli-0.11.0}/PKG-INFO +1 -1
  5. {guild_cli-0.10.4 → guild_cli-0.11.0}/docs/skill-sources.md +12 -12
  6. {guild_cli-0.10.4 → guild_cli-0.11.0}/guild/cli/_commands/_provision_template.py +15 -2
  7. {guild_cli-0.10.4 → guild_cli-0.11.0}/guild/cli/_commands/create.py +22 -2
  8. {guild_cli-0.10.4 → guild_cli-0.11.0}/pyproject.toml +1 -1
  9. {guild_cli-0.10.4 → guild_cli-0.11.0}/tests/test_cli_create.py +144 -2
  10. {guild_cli-0.10.4 → guild_cli-0.11.0}/uv.lock +1 -1
  11. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/agent-config/SKILL.md +0 -0
  12. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/agent-config/data/backend-fingerprints.yaml +0 -0
  13. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/agent-config/scripts/show.sh +0 -0
  14. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/assign-to-workforce/SKILL.md +0 -0
  15. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/assign-to-workforce/scripts/assign-to-workforce.sh +0 -0
  16. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/cicd/SKILL.md +0 -0
  17. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/cicd/scripts/_resolve-nick.sh +0 -0
  18. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/cicd/scripts/portability-lint.sh +0 -0
  19. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/cicd/scripts/pr-reply.sh +0 -0
  20. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/cicd/scripts/pr-status.sh +0 -0
  21. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/cicd/scripts/workflow.sh +0 -0
  22. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/communicate/SKILL.md +0 -0
  23. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/communicate/scripts/fetch-issues.sh +0 -0
  24. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/communicate/scripts/mesh-message.sh +0 -0
  25. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/communicate/scripts/post-comment.sh +0 -0
  26. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/communicate/scripts/post-issue.sh +0 -0
  27. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/communicate/scripts/templates/skill-new-brief.md +0 -0
  28. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/communicate/scripts/templates/skill-update-brief.md +0 -0
  29. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/doc-test-alignment/SKILL.md +0 -0
  30. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/doc-test-alignment/scripts/check.sh +0 -0
  31. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/guild/SKILL.md +0 -0
  32. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/guild/scripts/create.sh +0 -0
  33. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/guild/scripts/overview.sh +0 -0
  34. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/onboard/SKILL.md +0 -0
  35. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/onboard/scripts/onboard.sh +0 -0
  36. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/outsource/SKILL.md +0 -0
  37. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/outsource/prompts/explore.md +0 -0
  38. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/outsource/prompts/review.md +0 -0
  39. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/outsource/prompts/write.md +0 -0
  40. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/outsource/scripts/outsource.sh +0 -0
  41. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/pypi-maintainer/SKILL.md +0 -0
  42. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/pypi-maintainer/scripts/switch-source.sh +0 -0
  43. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/run-tests/SKILL.md +0 -0
  44. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/run-tests/scripts/test.sh +0 -0
  45. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/sonarclaude/SKILL.md +0 -0
  46. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/sonarclaude/scripts/sonar.sh +0 -0
  47. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/spec-to-plan/SKILL.md +0 -0
  48. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/spec-to-plan/scripts/spec-to-plan.sh +0 -0
  49. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/teach/SKILL.md +0 -0
  50. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/teach/scripts/teach.sh +0 -0
  51. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/think/SKILL.md +0 -0
  52. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/think/scripts/think.sh +0 -0
  53. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/version-bump/SKILL.md +0 -0
  54. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills/version-bump/scripts/bump.py +0 -0
  55. {guild_cli-0.10.4 → guild_cli-0.11.0}/.claude/skills.local.yaml.example +0 -0
  56. {guild_cli-0.10.4 → guild_cli-0.11.0}/.devague/frames/guildmaster-ships-teach-and-onboard-two-agent-firs.json +0 -0
  57. {guild_cli-0.10.4 → guild_cli-0.11.0}/.devague/plans/guildmaster-ships-teach-and-onboard-two-agent-firs.json +0 -0
  58. {guild_cli-0.10.4 → guild_cli-0.11.0}/.flake8 +0 -0
  59. {guild_cli-0.10.4 → guild_cli-0.11.0}/.github/workflows/publish.yml +0 -0
  60. {guild_cli-0.10.4 → guild_cli-0.11.0}/.github/workflows/tests.yml +0 -0
  61. {guild_cli-0.10.4 → guild_cli-0.11.0}/.gitignore +0 -0
  62. {guild_cli-0.10.4 → guild_cli-0.11.0}/.markdownlint-cli2.yaml +0 -0
  63. {guild_cli-0.10.4 → guild_cli-0.11.0}/LICENSE +0 -0
  64. {guild_cli-0.10.4 → guild_cli-0.11.0}/README.md +0 -0
  65. {guild_cli-0.10.4 → guild_cli-0.11.0}/culture.yaml +0 -0
  66. {guild_cli-0.10.4 → guild_cli-0.11.0}/docs/cutover.md +0 -0
  67. {guild_cli-0.10.4 → guild_cli-0.11.0}/docs/onboarding/reachy-mini-mcp.json +0 -0
  68. {guild_cli-0.10.4 → guild_cli-0.11.0}/docs/plans/2026-05-24-guildmaster-ships-teach-and-onboard-two-agent-firs.md +0 -0
  69. {guild_cli-0.10.4 → guild_cli-0.11.0}/docs/specs/2026-05-24-guildmaster-ships-teach-and-onboard-two-agent-firs.md +0 -0
  70. {guild_cli-0.10.4 → guild_cli-0.11.0}/guild/__init__.py +0 -0
  71. {guild_cli-0.10.4 → guild_cli-0.11.0}/guild/__main__.py +0 -0
  72. {guild_cli-0.10.4 → guild_cli-0.11.0}/guild/cli/__init__.py +0 -0
  73. {guild_cli-0.10.4 → guild_cli-0.11.0}/guild/cli/_commands/__init__.py +0 -0
  74. {guild_cli-0.10.4 → guild_cli-0.11.0}/guild/cli/_commands/_broadcast.py +0 -0
  75. {guild_cli-0.10.4 → guild_cli-0.11.0}/guild/cli/_commands/explain.py +0 -0
  76. {guild_cli-0.10.4 → guild_cli-0.11.0}/guild/cli/_commands/learn.py +0 -0
  77. {guild_cli-0.10.4 → guild_cli-0.11.0}/guild/cli/_commands/onboard.py +0 -0
  78. {guild_cli-0.10.4 → guild_cli-0.11.0}/guild/cli/_commands/overview.py +0 -0
  79. {guild_cli-0.10.4 → guild_cli-0.11.0}/guild/cli/_commands/show.py +0 -0
  80. {guild_cli-0.10.4 → guild_cli-0.11.0}/guild/cli/_commands/teach.py +0 -0
  81. {guild_cli-0.10.4 → guild_cli-0.11.0}/guild/cli/_commands/whoami.py +0 -0
  82. {guild_cli-0.10.4 → guild_cli-0.11.0}/guild/cli/_errors.py +0 -0
  83. {guild_cli-0.10.4 → guild_cli-0.11.0}/guild/cli/_output.py +0 -0
  84. {guild_cli-0.10.4 → guild_cli-0.11.0}/guild/cli/_repo.py +0 -0
  85. {guild_cli-0.10.4 → guild_cli-0.11.0}/guild/scaffold/__init__.py +0 -0
  86. {guild_cli-0.10.4 → guild_cli-0.11.0}/guild/scaffold/instantiate.py +0 -0
  87. {guild_cli-0.10.4 → guild_cli-0.11.0}/guild/skills/__init__.py +0 -0
  88. {guild_cli-0.10.4 → guild_cli-0.11.0}/guild/skills/identity.py +0 -0
  89. {guild_cli-0.10.4 → guild_cli-0.11.0}/guild/skills/ledger.py +0 -0
  90. {guild_cli-0.10.4 → guild_cli-0.11.0}/guild/skills/render.py +0 -0
  91. {guild_cli-0.10.4 → guild_cli-0.11.0}/guild/skills/sources.py +0 -0
  92. {guild_cli-0.10.4 → guild_cli-0.11.0}/sonar-project.properties +0 -0
  93. {guild_cli-0.10.4 → guild_cli-0.11.0}/tests/__init__.py +0 -0
  94. {guild_cli-0.10.4 → guild_cli-0.11.0}/tests/test_broadcast_post.py +0 -0
  95. {guild_cli-0.10.4 → guild_cli-0.11.0}/tests/test_cli.py +0 -0
  96. {guild_cli-0.10.4 → guild_cli-0.11.0}/tests/test_cli_explain.py +0 -0
  97. {guild_cli-0.10.4 → guild_cli-0.11.0}/tests/test_cli_learn.py +0 -0
  98. {guild_cli-0.10.4 → guild_cli-0.11.0}/tests/test_cli_onboard.py +0 -0
  99. {guild_cli-0.10.4 → guild_cli-0.11.0}/tests/test_cli_overview.py +0 -0
  100. {guild_cli-0.10.4 → guild_cli-0.11.0}/tests/test_cli_show.py +0 -0
  101. {guild_cli-0.10.4 → guild_cli-0.11.0}/tests/test_cli_teach.py +0 -0
  102. {guild_cli-0.10.4 → guild_cli-0.11.0}/tests/test_cli_whoami.py +0 -0
  103. {guild_cli-0.10.4 → guild_cli-0.11.0}/tests/test_scaffold_instantiate.py +0 -0
  104. {guild_cli-0.10.4 → guild_cli-0.11.0}/tests/test_skills_convention.py +0 -0
  105. {guild_cli-0.10.4 → guild_cli-0.11.0}/tests/test_skills_identity.py +0 -0
  106. {guild_cli-0.10.4 → guild_cli-0.11.0}/tests/test_skills_ledger.py +0 -0
  107. {guild_cli-0.10.4 → guild_cli-0.11.0}/tests/test_skills_render.py +0 -0
  108. {guild_cli-0.10.4 → guild_cli-0.11.0}/tests/test_skills_sources.py +0 -0
  109. {guild_cli-0.10.4 → guild_cli-0.11.0}/tests/test_version_fallback.py +0 -0
@@ -43,6 +43,27 @@ command -v gh >/dev/null 2>&1 || { echo "configure-repo: 'gh' not on PATH" >&2;
43
43
 
44
44
  say() { if $apply; then echo " ✓ $1"; else echo " would: $1"; fi; }
45
45
 
46
+ # Run a gh write that GitHub gates behind a paid plan for PRIVATE repos
47
+ # (environments, rulesets). The ✓/⚠ line is printed only AFTER the call returns,
48
+ # so the log never claims success before the attempt. On that specific 403 —
49
+ # "Upgrade to GitHub Pro or make this repository public" — warn (to stderr) and
50
+ # continue so a private `guild create` still succeeds on free-tier accounts; any
51
+ # other failure stays fatal (output re-emitted to stderr, and the non-zero
52
+ # return trips `set -e` in the caller).
53
+ pro_gated_apply() {
54
+ what="$1"; shift
55
+ if out="$("$@" 2>&1)"; then
56
+ echo " ✓ $what"
57
+ return 0
58
+ fi
59
+ if printf '%s\n' "$out" | grep -qiE 'Upgrade to GitHub Pro|make this repository public'; then
60
+ echo " ⚠ skipped $what — requires GitHub Pro/Team for private repos (apply after upgrade or when the repo is public)" >&2
61
+ return 0
62
+ fi
63
+ printf '%s\n' "$out" >&2
64
+ return 1
65
+ }
66
+
46
67
  echo "── configure-repo: $repo $([ "$apply" = true ] && echo '(--apply)' || echo '(dry-run)') ──"
47
68
 
48
69
  # 1. auto-delete-on-merge ---------------------------------------------------
@@ -53,9 +74,10 @@ fi
53
74
 
54
75
  # 2. environments -----------------------------------------------------------
55
76
  for env in "${ENVIRONMENTS[@]}"; do
56
- say "ensure environment '$env'"
57
77
  if $apply; then
58
- gh api -X PUT "repos/$repo/environments/$env" >/dev/null
78
+ pro_gated_apply "environment '$env'" gh api -X PUT "repos/$repo/environments/$env"
79
+ else
80
+ say "ensure environment '$env'"
59
81
  fi
60
82
  done
61
83
 
@@ -65,8 +87,8 @@ if ! $apply; then
65
87
  elif gh api "repos/$repo/rulesets" --jq '.[].name' 2>/dev/null | grep -Fxq "$RULESET_NAME"; then
66
88
  echo " • ruleset '$RULESET_NAME' already present — skipping"
67
89
  else
68
- echo " ✓ create ruleset '$RULESET_NAME' (deletion + non_fast_forward + pull_request)"
69
- gh api -X POST "repos/$repo/rulesets" --input - >/dev/null <<JSON
90
+ pro_gated_apply "ruleset '$RULESET_NAME' (deletion + non_fast_forward + pull_request)" \
91
+ gh api -X POST "repos/$repo/rulesets" --input - <<JSON
70
92
  {
71
93
  "name": "$RULESET_NAME",
72
94
  "target": "branch",
@@ -5,6 +5,38 @@ All notable changes to this project will be documented in this file.
5
5
  Format follows [Keep a Changelog](https://keepachangelog.com/). This project
6
6
  adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [0.11.0] - 2026-06-10
9
+
10
+ ### Added
11
+
12
+ - **`guild create` now defaults to a PRIVATE repo, with `--public` to opt out.**
13
+ The `culture-agent-template` is itself private, so new siblings are created
14
+ private by default; pass `--public` for siblings meant to be open. The flag
15
+ flips the `gh repo create` visibility from `--private` to `--public`, and the
16
+ resolved visibility is surfaced in the dry-run render (`visibility :
17
+ private`/`public`) and the `--json` payload (`"private"`). **Behavioral change:**
18
+ a bare `guild create` previously produced a public repo and now produces a
19
+ private one.
20
+ - **`configure-repo.sh` tolerates the GitHub Pro/Team gate on private repos.**
21
+ Environments and branch-protection rulesets return a 403 (`Upgrade to GitHub
22
+ Pro or make this repository public`) for private repos on free-tier accounts.
23
+ The new `pro_gated_apply` helper warns-and-continues on exactly that 403 (any
24
+ other failure stays fatal), so provisioning a private sibling completes cleanly
25
+ instead of aborting after the repo + genesis already exist. Branch protection
26
+ is simply not applied until the repo is upgraded to a paid plan or made public.
27
+ The skip warning is written to **stderr** and `guild create` re-emits it as a
28
+ diagnostic (stdout stays clean for `--json`), so the skip is never swallowed by
29
+ the provisioning runner; the `✓`/`⚠` status line is printed only *after* the
30
+ call returns, never optimistically before it.
31
+ - **Registered `agent-lifecycle` in the skills ledger** as a downstream consumer
32
+ of the canonical kit. `agent-lifecycle` is a new (private) sibling chartered by
33
+ `culture` (guildmaster#61): a harness- and transport-agnostic agent runtime
34
+ extracted from `cultureagent`.
35
+
36
+ ### Changed
37
+
38
+ ### Fixed
39
+
8
40
  ## [0.10.4] - 2026-06-07
9
41
 
10
42
  ### Changed
@@ -108,7 +108,7 @@ two live broadcasters.
108
108
 
109
109
  **Provisioning verb — `guild create` (template-instantiate a new sibling).**
110
110
 
111
- - `guild create --agent OWNER/REPO --desc TEXT [--backend claude|acp] [--workspace-root DIR] [--template agentculture/culture-agent-template] [--command NAME] [--pkg NAME] [--dist NAME] [--apply] [--json]` — provision a brand-new AgentCulture sibling by instantiating the GitHub template, renaming identifiers throughout the clone, writing a self-init CLAUDE.md seed, configuring the GitHub repo (branch protection, environments, SONAR_TOKEN placeholder), pushing the genesis commit, and registering the agent in `docs/skill-sources.md`. Dry-run by default; `--apply` executes. The transform is **pure** (unit-testable against a fixture dir; no network): `culture_agent_template` → pkg (underscore form, e.g. `my_agent`), `culture-agent-template` → repo token (hyphen form, e.g. `my-agent`). **The repo token is the repo/agent identity only** — it always drives the README heading, `culture.yaml` suffix, CLAUDE.md seed, and repo URL. The **command**, **import package**, and **dist** are each independently retargetable and default to the repo token (or, for `--pkg`, the underscore form of `--command`); with no overrides the output is byte-identical to a plain rename. `--command NAME` sets the **console-command (binary) name** (default: the repo token) and retargets **only** the `[project.scripts]` entry-point key — e.g. `--command reachy` for repo `reachy-mini-cli` ships the command as `reachy`. `--pkg NAME` sets the **importable Python package** (default: the underscore form of `--command`, so command and import package stay in lock-step like `guild`/`guild`); pass it only to decouple the two. `--dist NAME` sets the **PyPI distribution name** (default: the repo token); pass e.g. `--dist jetson-cli` to publish as `jetson-cli` while keeping the command and import package as the repo token (`jetson`) — this retargets only `[project].name`, the `importlib.metadata` lookup, and the TestPyPI install pin, matching the `guild-cli`/`guild` convention without a manual post-create edit. (Renaming the dist or command does **not** register a Trusted Publisher — that needs a matching Trusted Publisher registered for the project name on PyPI/TestPyPI; `guild create` configures the GitHub side only.) The CLAUDE.md seed is a `/init`-style bootstrap placeholder — run `/init` in the new repo after provisioning to expand it into a full runtime prompt. Implementation: `guild/scaffold/instantiate.py` (pure transform: `_resolve_identifiers` + `_retarget_command` / `_retarget_dist`), `guild/cli/_commands/create.py` (CLI), `guild/cli/_commands/_provision_template.py` (injectable-runner executor), `.claude/skills/guild/scripts/create.sh` (thin wrapper).
111
+ - `guild create --agent OWNER/REPO --desc TEXT [--backend claude|acp] [--workspace-root DIR] [--template agentculture/culture-agent-template] [--command NAME] [--pkg NAME] [--dist NAME] [--public] [--apply] [--json]` — provision a brand-new AgentCulture sibling by instantiating the GitHub template, renaming identifiers throughout the clone, writing a self-init CLAUDE.md seed, configuring the GitHub repo (branch protection, environments, SONAR_TOKEN placeholder), pushing the genesis commit, and registering the agent in `docs/skill-sources.md`. Dry-run by default; `--apply` executes. **New repos are private by default** (the `culture-agent-template` is itself private); pass `--public` to create an open sibling. Branch-protection rulesets (and environments) are GitHub Pro/Team-gated for private repos on free-tier accounts, so `configure-repo.sh` warns-and-skips the gated `gh` calls (any other failure stays fatal) and applies the rest — a private create still completes; re-run `configure-repo.sh` after a Pro upgrade or after going public to add the ruleset. The transform is **pure** (unit-testable against a fixture dir; no network): `culture_agent_template` → pkg (underscore form, e.g. `my_agent`), `culture-agent-template` → repo token (hyphen form, e.g. `my-agent`). **The repo token is the repo/agent identity only** — it always drives the README heading, `culture.yaml` suffix, CLAUDE.md seed, and repo URL. The **command**, **import package**, and **dist** are each independently retargetable and default to the repo token (or, for `--pkg`, the underscore form of `--command`); with no overrides the output is byte-identical to a plain rename. `--command NAME` sets the **console-command (binary) name** (default: the repo token) and retargets **only** the `[project.scripts]` entry-point key — e.g. `--command reachy` for repo `reachy-mini-cli` ships the command as `reachy`. `--pkg NAME` sets the **importable Python package** (default: the underscore form of `--command`, so command and import package stay in lock-step like `guild`/`guild`); pass it only to decouple the two. `--dist NAME` sets the **PyPI distribution name** (default: the repo token); pass e.g. `--dist jetson-cli` to publish as `jetson-cli` while keeping the command and import package as the repo token (`jetson`) — this retargets only `[project].name`, the `importlib.metadata` lookup, and the TestPyPI install pin, matching the `guild-cli`/`guild` convention without a manual post-create edit. (Renaming the dist or command does **not** register a Trusted Publisher — that needs a matching Trusted Publisher registered for the project name on PyPI/TestPyPI; `guild create` configures the GitHub side only.) The CLAUDE.md seed is a `/init`-style bootstrap placeholder — run `/init` in the new repo after provisioning to expand it into a full runtime prompt. Implementation: `guild/scaffold/instantiate.py` (pure transform: `_resolve_identifiers` + `_retarget_command` / `_retarget_dist`), `guild/cli/_commands/create.py` (CLI), `guild/cli/_commands/_provision_template.py` (injectable-runner executor), `.claude/skills/guild/scripts/create.sh` (thin wrapper).
112
112
 
113
113
  **Inventory verbs — `overview` & `show` (the read-only surfaces).** guildmaster
114
114
  owns the mesh's *inventory* surfaces per
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: guild-cli
3
- Version: 0.10.4
3
+ Version: 0.11.0
4
4
  Summary: guildmaster — an agent and CLI that manages skills for the AgentCulture mesh.
5
5
  Project-URL: Homepage, https://github.com/agentculture/guildmaster
6
6
  Project-URL: Issues, https://github.com/agentculture/guildmaster/issues
@@ -32,14 +32,14 @@ current by `guild overview --scope mesh`.
32
32
 
33
33
  | Skill | Upstream | Downstream copies (known) | Notes |
34
34
  |-------|----------|---------------------------|-------|
35
- | `agent-config` | `guildmaster` (`.claude/skills/agent-config/`) | `agenda`, `dominion-breaker`, `colleague`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli`, `reachy-mini-mcp`, `tensor-cli`, `climate-cli`, `eidetic-cli`, `prove-cli`, `reduce-cli`, `refactor-cli`, `rollout-cli`, `coherence-cli` | Inventory variant backing `guild show` ([#12](https://github.com/agentculture/guildmaster/issues/12)); `show.sh` + `data/backend-fingerprints.yaml` vendored verbatim from steward, SKILL.md reframed from alignment-judgment to inventory + `type: command` added. **Forked from steward:** steward retains its own alignment-focused `agent-config` variant; the inventory variant is guildmaster's to supply. |
36
- | `cicd` | `guildmaster` (`.claude/skills/cicd/`) — layered on `devex pr` (in `agentculture/devex`) | `afi-cli`, `devex` (adapted-thin delegate — owns `devex pr`; see [devex#53](https://github.com/agentculture/devex/pull/53)), `agtag`, `antoine`, `appsec`, `auntiepypi`, `cfafi` (still named `pr-review`), `code-lens-cli`, `culture` (still named `pr-review`), `devague`, `katvan`, `lecodeur`, `lepenseur`, `seer-cli`, `telek`, `agenda`, `dominion-breaker`, `colleague`, `jetson`, `grant` (still named `pr-review`), `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli`, `reachy-mini-mcp`, `tensor-cli`, `climate-cli`, `eidetic-cli`, `prove-cli`, `reduce-cli`, `refactor-cli`, `rollout-cli`, `coherence-cli` | Thin delegate to `devex pr` for lint / open / read / reply / delta, plus guildmaster's `status` (SonarCloud quality gate + hotspots + unresolved-thread tally) and `await` (composes `devex pr read --wait` with `status`, non-zero exit on Sonar ERROR / unresolved threads) extensions. **Inverted case:** devex, as the `devex pr` upstream, vendors the skill adapted-thin — a `workflow.sh`-only pure delegate ([devex#53](https://github.com/agentculture/devex/pull/53)). Renamed from `pr-review` in steward 0.7.0; downstream copies may keep the old name on their own cadence. |
37
- | `communicate` | `guildmaster` (`.claude/skills/communicate/`) | `afi-cli`, `devex` (identifier-only — vendored steward 0.11.0; scripts current as of 0.18.0), `agtag`, `antoine`, `appsec`, `auntiepypi`, `code-lens-cli`, `culture` (still named `coordinate`), `devague`, `katvan`, `lecodeur`, `lepenseur`, `seer-cli`, `telek`, `agenda`, `dominion-breaker`, `colleague`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli`, `reachy-mini-mcp`, `tensor-cli`, `climate-cli`, `eidetic-cli`, `prove-cli`, `reduce-cli`, `refactor-cli`, `rollout-cli`, `coherence-cli` | Cross-repo + mesh communication: file issues / hand off briefs to sibling-repo agents (auto-signed), comment on existing issues, fetch issues to inline state into briefs, and send live messages to Culture mesh channels (unsigned — nick is the speaker). Renamed from `coordinate` in steward 0.8.0; absorbed `gh-issues` (as `fetch-issues.sh`) in 0.9.1. Issue I/O backed by `agtag` (>=0.1) since steward 0.11.0 — signature resolves from local `culture.yaml` (override via `--as`). |
38
- | `doc-test-alignment` | `guildmaster` (`.claude/skills/doc-test-alignment/`) | `devague`, `lecodeur`, `lepenseur`, `agenda`, `dominion-breaker`, `colleague`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli`, `reachy-mini-mcp`, `tensor-cli`, `climate-cli`, `eidetic-cli`, `prove-cli`, `reduce-cli`, `refactor-cli`, `rollout-cli`, `coherence-cli` | Stub; real implementation TBD. `scripts/check.sh` exits not-yet-implemented today. |
39
- | `pypi-maintainer` | `guildmaster` (`.claude/skills/pypi-maintainer/`) | `agtag`, `agenda`, `dominion-breaker`, `colleague`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli`, `reachy-mini-mcp`, `tensor-cli`, `climate-cli`, `eidetic-cli`, `prove-cli`, `reduce-cli`, `refactor-cli`, `rollout-cli`, `coherence-cli` | Switches a PyPI package install between pypi / test-pypi / local. Generalised from the original culture-specific `change-package`. |
40
- | `run-tests` | `guildmaster` (`.claude/skills/run-tests/`) | `agtag`, `antoine`, `appsec`, `code-lens-cli`, `culture`, `culture-sonar-cli`, `devague`, `lecodeur`, `lepenseur`, `seer-cli`, `grant`, `telek`, `agenda`, `dominion-breaker`, `colleague`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli`, `reachy-mini-mcp`, `tensor-cli`, `climate-cli`, `eidetic-cli`, `prove-cli`, `reduce-cli`, `refactor-cli`, `rollout-cli`, `coherence-cli` | Coverage source resolves from `[tool.coverage.run]` in `pyproject.toml`, so the script is portable across siblings without modification. |
41
- | `sonarclaude` | `guildmaster` (`.claude/skills/sonarclaude/`) | `antoine`, `appsec`, `code-lens-cli`, `devague`, `lecodeur`, `lepenseur`, `seer-cli`, `telek`, `agenda`, `dominion-breaker`, `colleague`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli`, `reachy-mini-mcp`, `tensor-cli`, `climate-cli`, `eidetic-cli`, `prove-cli`, `reduce-cli`, `refactor-cli`, `rollout-cli`, `coherence-cli` | SonarCloud API client. Project key resolves from `$SONAR_PROJECT` or `--project KEY`. |
42
- | `version-bump` | `guildmaster` (`.claude/skills/version-bump/`) | `afi-cli`, `agtag`, `antoine`, `appsec`, `auntiepypi`, `cfafi`, `code-lens-cli`, `culture`, `devague`, `lecodeur`, `lepenseur`, `seer-cli`, `grant`, `telek`, `agenda`, `dominion-breaker`, `colleague`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli`, `reachy-mini-mcp`, `tensor-cli`, `climate-cli`, `eidetic-cli`, `prove-cli`, `reduce-cli`, `refactor-cli`, `rollout-cli`, `coherence-cli` | Pure Python, prepends a Keep-a-Changelog entry; no per-repo customization needed. |
35
+ | `agent-config` | `guildmaster` (`.claude/skills/agent-config/`) | `agenda`, `dominion-breaker`, `colleague`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli`, `reachy-mini-mcp`, `tensor-cli`, `climate-cli`, `eidetic-cli`, `prove-cli`, `reduce-cli`, `refactor-cli`, `rollout-cli`, `coherence-cli`, `agent-lifecycle` | Inventory variant backing `guild show` ([#12](https://github.com/agentculture/guildmaster/issues/12)); `show.sh` + `data/backend-fingerprints.yaml` vendored verbatim from steward, SKILL.md reframed from alignment-judgment to inventory + `type: command` added. **Forked from steward:** steward retains its own alignment-focused `agent-config` variant; the inventory variant is guildmaster's to supply. |
36
+ | `cicd` | `guildmaster` (`.claude/skills/cicd/`) — layered on `devex pr` (in `agentculture/devex`) | `afi-cli`, `devex` (adapted-thin delegate — owns `devex pr`; see [devex#53](https://github.com/agentculture/devex/pull/53)), `agtag`, `antoine`, `appsec`, `auntiepypi`, `cfafi` (still named `pr-review`), `code-lens-cli`, `culture` (still named `pr-review`), `devague`, `katvan`, `lecodeur`, `lepenseur`, `seer-cli`, `telek`, `agenda`, `dominion-breaker`, `colleague`, `jetson`, `grant` (still named `pr-review`), `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli`, `reachy-mini-mcp`, `tensor-cli`, `climate-cli`, `eidetic-cli`, `prove-cli`, `reduce-cli`, `refactor-cli`, `rollout-cli`, `coherence-cli`, `agent-lifecycle` | Thin delegate to `devex pr` for lint / open / read / reply / delta, plus guildmaster's `status` (SonarCloud quality gate + hotspots + unresolved-thread tally) and `await` (composes `devex pr read --wait` with `status`, non-zero exit on Sonar ERROR / unresolved threads) extensions. **Inverted case:** devex, as the `devex pr` upstream, vendors the skill adapted-thin — a `workflow.sh`-only pure delegate ([devex#53](https://github.com/agentculture/devex/pull/53)). Renamed from `pr-review` in steward 0.7.0; downstream copies may keep the old name on their own cadence. |
37
+ | `communicate` | `guildmaster` (`.claude/skills/communicate/`) | `afi-cli`, `devex` (identifier-only — vendored steward 0.11.0; scripts current as of 0.18.0), `agtag`, `antoine`, `appsec`, `auntiepypi`, `code-lens-cli`, `culture` (still named `coordinate`), `devague`, `katvan`, `lecodeur`, `lepenseur`, `seer-cli`, `telek`, `agenda`, `dominion-breaker`, `colleague`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli`, `reachy-mini-mcp`, `tensor-cli`, `climate-cli`, `eidetic-cli`, `prove-cli`, `reduce-cli`, `refactor-cli`, `rollout-cli`, `coherence-cli`, `agent-lifecycle` | Cross-repo + mesh communication: file issues / hand off briefs to sibling-repo agents (auto-signed), comment on existing issues, fetch issues to inline state into briefs, and send live messages to Culture mesh channels (unsigned — nick is the speaker). Renamed from `coordinate` in steward 0.8.0; absorbed `gh-issues` (as `fetch-issues.sh`) in 0.9.1. Issue I/O backed by `agtag` (>=0.1) since steward 0.11.0 — signature resolves from local `culture.yaml` (override via `--as`). |
38
+ | `doc-test-alignment` | `guildmaster` (`.claude/skills/doc-test-alignment/`) | `devague`, `lecodeur`, `lepenseur`, `agenda`, `dominion-breaker`, `colleague`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli`, `reachy-mini-mcp`, `tensor-cli`, `climate-cli`, `eidetic-cli`, `prove-cli`, `reduce-cli`, `refactor-cli`, `rollout-cli`, `coherence-cli`, `agent-lifecycle` | Stub; real implementation TBD. `scripts/check.sh` exits not-yet-implemented today. |
39
+ | `pypi-maintainer` | `guildmaster` (`.claude/skills/pypi-maintainer/`) | `agtag`, `agenda`, `dominion-breaker`, `colleague`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli`, `reachy-mini-mcp`, `tensor-cli`, `climate-cli`, `eidetic-cli`, `prove-cli`, `reduce-cli`, `refactor-cli`, `rollout-cli`, `coherence-cli`, `agent-lifecycle` | Switches a PyPI package install between pypi / test-pypi / local. Generalised from the original culture-specific `change-package`. |
40
+ | `run-tests` | `guildmaster` (`.claude/skills/run-tests/`) | `agtag`, `antoine`, `appsec`, `code-lens-cli`, `culture`, `culture-sonar-cli`, `devague`, `lecodeur`, `lepenseur`, `seer-cli`, `grant`, `telek`, `agenda`, `dominion-breaker`, `colleague`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli`, `reachy-mini-mcp`, `tensor-cli`, `climate-cli`, `eidetic-cli`, `prove-cli`, `reduce-cli`, `refactor-cli`, `rollout-cli`, `coherence-cli`, `agent-lifecycle` | Coverage source resolves from `[tool.coverage.run]` in `pyproject.toml`, so the script is portable across siblings without modification. |
41
+ | `sonarclaude` | `guildmaster` (`.claude/skills/sonarclaude/`) | `antoine`, `appsec`, `code-lens-cli`, `devague`, `lecodeur`, `lepenseur`, `seer-cli`, `telek`, `agenda`, `dominion-breaker`, `colleague`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli`, `reachy-mini-mcp`, `tensor-cli`, `climate-cli`, `eidetic-cli`, `prove-cli`, `reduce-cli`, `refactor-cli`, `rollout-cli`, `coherence-cli`, `agent-lifecycle` | SonarCloud API client. Project key resolves from `$SONAR_PROJECT` or `--project KEY`. |
42
+ | `version-bump` | `guildmaster` (`.claude/skills/version-bump/`) | `afi-cli`, `agtag`, `antoine`, `appsec`, `auntiepypi`, `cfafi`, `code-lens-cli`, `culture`, `devague`, `lecodeur`, `lepenseur`, `seer-cli`, `grant`, `telek`, `agenda`, `dominion-breaker`, `colleague`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli`, `reachy-mini-mcp`, `tensor-cli`, `climate-cli`, `eidetic-cli`, `prove-cli`, `reduce-cli`, `refactor-cli`, `rollout-cli`, `coherence-cli`, `agent-lifecycle` | Pure Python, prepends a Keep-a-Changelog entry; no per-repo customization needed. |
43
43
 
44
44
  > **How the downstream column is maintained.** The "Downstream copies (known)"
45
45
  > entries are kept in sync with guildmaster's own drift detector:
@@ -86,9 +86,9 @@ harmless on `claude-code`. This is the only divergence from upstream.
86
86
 
87
87
  | Skill | Origin | Downstream copies (known) | Notes |
88
88
  |-------|--------|---------------------------|-------|
89
- | `think` | `devague` (`agentculture/devague`, `../devague/.claude/skills/think/`) | — (broadcast pending), `agenda`, `dominion-breaker`, `colleague`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli`, `reachy-mini-mcp`, `tensor-cli`, `climate-cli`, `eidetic-cli`, `prove-cli`, `reduce-cli`, `refactor-cli`, `rollout-cli`, `coherence-cli` | Operator for the **idea→spec** leg (announcement frame → capture/classify claims → interrogate with honesty conditions → park open vagueness → `export` once the frame converges). Renamed from `devague` in devague 0.4.0. **Divergence:** `type: command` added. Runtime dep: `uv tool install devague`. |
90
- | `spec-to-plan` | `devague` (`agentculture/devague`, `../devague/.claude/skills/spec-to-plan/`) | — (broadcast pending), `agenda`, `dominion-breaker`, `colleague`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli`, `reachy-mini-mcp`, `tensor-cli`, `climate-cli`, `eidetic-cli`, `prove-cli`, `reduce-cli`, `refactor-cli`, `rollout-cli`, `coherence-cli` | Operator for the **spec→plan** leg (`devague plan ...`): seed from a converged frame, cover every coverage target with acceptance-gated, acyclically-ordered tasks, park unknowns as risks, `export` once the plan converges. New in devague 0.4.0. **Divergence:** `type: command` added. Runtime dep: `uv tool install devague`. |
91
- | `assign-to-workforce` | `devague` (`agentculture/devague`, `../devague/.claude/skills/assign-to-workforce/`) | — (broadcast pending), `agenda`, `dominion-breaker`, `colleague`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli`, `reachy-mini-mcp`, `tensor-cli`, `climate-cli`, `eidetic-cli`, `prove-cli`, `reduce-cli`, `refactor-cli`, `rollout-cli`, `coherence-cli` | Operator for the **implementation** leg: reads `devague plan waves` (read-only) and fans out independent tasks to one agent per task per wave in isolated git worktrees, with main-agent TDD-gated merges. Three human gates: spec / split plan / final PR. The CLI stays non-orchestrating ([devague#20](https://github.com/agentculture/devague/issues/20)). New in devague 0.10.0. **Divergence:** `type: command` added. Runtime deps: `uv tool install devague`, `git worktree`, the vendored `cicd` skill (for gate-3 `devex pr open`). |
89
+ | `think` | `devague` (`agentculture/devague`, `../devague/.claude/skills/think/`) | — (broadcast pending), `agenda`, `dominion-breaker`, `colleague`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli`, `reachy-mini-mcp`, `tensor-cli`, `climate-cli`, `eidetic-cli`, `prove-cli`, `reduce-cli`, `refactor-cli`, `rollout-cli`, `coherence-cli`, `agent-lifecycle` | Operator for the **idea→spec** leg (announcement frame → capture/classify claims → interrogate with honesty conditions → park open vagueness → `export` once the frame converges). Renamed from `devague` in devague 0.4.0. **Divergence:** `type: command` added. Runtime dep: `uv tool install devague`. |
90
+ | `spec-to-plan` | `devague` (`agentculture/devague`, `../devague/.claude/skills/spec-to-plan/`) | — (broadcast pending), `agenda`, `dominion-breaker`, `colleague`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli`, `reachy-mini-mcp`, `tensor-cli`, `climate-cli`, `eidetic-cli`, `prove-cli`, `reduce-cli`, `refactor-cli`, `rollout-cli`, `coherence-cli`, `agent-lifecycle` | Operator for the **spec→plan** leg (`devague plan ...`): seed from a converged frame, cover every coverage target with acceptance-gated, acyclically-ordered tasks, park unknowns as risks, `export` once the plan converges. New in devague 0.4.0. **Divergence:** `type: command` added. Runtime dep: `uv tool install devague`. |
91
+ | `assign-to-workforce` | `devague` (`agentculture/devague`, `../devague/.claude/skills/assign-to-workforce/`) | — (broadcast pending), `agenda`, `dominion-breaker`, `colleague`, `jetson`, `reachy-mini-cli`, `jetson-ai-lab-cli`, `dgx-spark-cli`, `unsloth-cli`, `discord-bot-cli`, `arxivist`, `rtx-spark-cli`, `reachy-mini-mcp`, `tensor-cli`, `climate-cli`, `eidetic-cli`, `prove-cli`, `reduce-cli`, `refactor-cli`, `rollout-cli`, `coherence-cli`, `agent-lifecycle` | Operator for the **implementation** leg: reads `devague plan waves` (read-only) and fans out independent tasks to one agent per task per wave in isolated git worktrees, with main-agent TDD-gated merges. Three human gates: spec / split plan / final PR. The CLI stays non-orchestrating ([devague#20](https://github.com/agentculture/devague/issues/20)). New in devague 0.10.0. **Divergence:** `type: command` added. Runtime deps: `uv tool install devague`, `git worktree`, the vendored `cicd` skill (for gate-3 `devex pr open`). |
92
92
 
93
93
  Downstream is empty by design: these are still being introduced to the mesh.
94
94
  `guild teach --new --skill <name> --to <repos>` frames them as *new* skills to
@@ -136,7 +136,7 @@ the CLI, the wrapper exits with a clear install hint rather than crashing.
136
136
 
137
137
  | Skill | Origin | Downstream copies (known) | Notes |
138
138
  |-------|--------|---------------------------|-------|
139
- | `outsource` | `colleague` (`agentculture/colleague`, `../colleague/.claude/skills/outsource/`) | — (broadcast pending; [`culture-agent-template#8`](https://github.com/agentculture/culture-agent-template/issues/8) proposes adding it to the clone template), `rtx-spark-cli`, `reachy-mini-mcp`, `tensor-cli`, `climate-cli`, `eidetic-cli`, `prove-cli`, `reduce-cli`, `refactor-cli`, `rollout-cli`, `coherence-cli` | First-party colleague skill: hand a scoped task to a *different* engine/mind. Verbs `explore` / `review` / `write`. **Divergence:** Provenance paragraph reframed for re-broadcast (above); `type: command` already present upstream. Runtime dep: `uv tool install colleague-cli` + a reachable engine. |
139
+ | `outsource` | `colleague` (`agentculture/colleague`, `../colleague/.claude/skills/outsource/`) | — (broadcast pending; [`culture-agent-template#8`](https://github.com/agentculture/culture-agent-template/issues/8) proposes adding it to the clone template), `rtx-spark-cli`, `reachy-mini-mcp`, `tensor-cli`, `climate-cli`, `eidetic-cli`, `prove-cli`, `reduce-cli`, `refactor-cli`, `rollout-cli`, `coherence-cli`, `agent-lifecycle` | First-party colleague skill: hand a scoped task to a *different* engine/mind. Verbs `explore` / `review` / `write`. **Divergence:** Provenance paragraph reframed for re-broadcast (above); `type: command` already present upstream. Runtime dep: `uv tool install colleague-cli` + a reachable engine. |
140
140
 
141
141
  Downstream is empty by design — guildmaster is the first holder outside
142
142
  colleague. `guild teach --new --skill outsource --to <repos>` frames it as a
@@ -16,7 +16,7 @@ Sequence (``--apply``)
16
16
  1. ``gh repo view <agent>`` (preflight: repo must NOT exist)
17
17
  2. ``gh repo create <agent>`` (template instantiation)
18
18
  `` --template <template>``
19
- `` --public``
19
+ `` --private`` / ``--public`` (visibility; --private by default)
20
20
  `` --description <desc>``
21
21
  3. ``git clone https://github.com/<agent>.git <clone_dest>``
22
22
  4. transform_clone(<clone_dest>, bare, desc, backend) (pure, local, no runner)
@@ -244,6 +244,7 @@ def apply(
244
244
  dist: str | None = None,
245
245
  command: str | None = None,
246
246
  pkg: str | None = None,
247
+ public: bool = False,
247
248
  poll_attempts: int = 30,
248
249
  poll_delay: float = 2.0,
249
250
  ) -> dict:
@@ -277,6 +278,10 @@ def apply(
277
278
  pkg:
278
279
  Importable package name. ``None`` defaults to the underscore form of the
279
280
  effective command (see ``transform_clone``).
281
+ public:
282
+ Repo visibility. ``False`` (default) creates a ``--private`` repo, matching
283
+ the (private) ``culture-agent-template``; ``True`` creates a ``--public``
284
+ repo for siblings that are meant to be open.
280
285
  poll_attempts / poll_delay:
281
286
  ``gh repo create --template`` copies the template content
282
287
  **asynchronously**; cloning immediately yields an empty repo. After
@@ -304,6 +309,7 @@ def apply(
304
309
  preflight(agent, clone_dest, runner=runner)
305
310
 
306
311
  # Step 2 — create the repo from the template.
312
+ visibility = "--public" if public else "--private"
307
313
  create = runner(
308
314
  [
309
315
  "gh",
@@ -312,7 +318,7 @@ def apply(
312
318
  agent,
313
319
  "--template",
314
320
  template,
315
- "--public",
321
+ visibility,
316
322
  "--description",
317
323
  desc,
318
324
  ]
@@ -352,13 +358,20 @@ def apply(
352
358
 
353
359
  # Step 8 — configure-repo.sh LAST: its "Protect main" ruleset requires PRs,
354
360
  # so applying it before the genesis push would get that push rejected.
361
+ configure_output = ""
355
362
  configure_script = guildmaster_root / CONFIGURE_REPO_SCRIPT
356
363
  if configure_script.is_file():
357
364
  cfg = runner([_BASH, str(configure_script), agent, "--apply"])
358
365
  _check(cfg, f"configure-repo.sh {agent} failed", EXIT_ENV_ERROR)
366
+ # configure-repo.sh writes its Pro-gate skip warnings (and any other
367
+ # diagnostics) to stderr. The runner captures them, so surface them to
368
+ # the caller — otherwise a private create that silently skipped
369
+ # environments/rulesets is reported as fully configured.
370
+ configure_output = (cfg.stderr or "").strip()
359
371
 
360
372
  return {
361
373
  "repo": agent,
362
374
  "clone_dest": str(clone_dest),
363
375
  "pushed": True,
376
+ "configure_output": configure_output,
364
377
  }
@@ -16,7 +16,7 @@ Usage
16
16
  [--backend claude|acp] [--workspace-root DIR]
17
17
  [--template agentculture/culture-agent-template]
18
18
  [--command NAME] [--pkg NAME] [--dist NAME]
19
- [--apply] [--json]
19
+ [--public] [--apply] [--json]
20
20
  """
21
21
 
22
22
  from __future__ import annotations
@@ -31,7 +31,7 @@ from pathlib import Path
31
31
  from guild.cli._commands import _broadcast
32
32
  from guild.cli._commands import _provision_template as _provision
33
33
  from guild.cli._errors import EXIT_USER_ERROR, GuildError
34
- from guild.cli._output import emit_result
34
+ from guild.cli._output import emit_diagnostic, emit_result
35
35
  from guild.cli._repo import repo_root
36
36
  from guild.scaffold.instantiate import transform_plan as _transform_plan
37
37
  from guild.skills import ledger as _ledger
@@ -128,6 +128,15 @@ def register(sub: argparse._SubParsersAction) -> None:
128
128
  "[project].name, the importlib.metadata lookup, and the TestPyPI pin."
129
129
  ),
130
130
  )
131
+ parser.add_argument(
132
+ "--public",
133
+ action="store_true",
134
+ help=(
135
+ "Create the GitHub repo public. The default is PRIVATE — the "
136
+ "culture-agent-template is itself private, so siblings are created "
137
+ "private unless you opt into public with this flag."
138
+ ),
139
+ )
131
140
  parser.add_argument(
132
141
  "--apply",
133
142
  action="store_true",
@@ -238,6 +247,7 @@ def _handle(args: argparse.Namespace) -> None:
238
247
  "agent": agent,
239
248
  "backend": args.backend,
240
249
  "template": args.template,
250
+ "private": not args.public,
241
251
  "clone_dest": str(clone_dest),
242
252
  "plan": plan,
243
253
  "ledger_diff": ledger_diff,
@@ -257,8 +267,16 @@ def _handle(args: argparse.Namespace) -> None:
257
267
  dist=args.dist,
258
268
  command=args.command_name,
259
269
  pkg=args.pkg,
270
+ public=args.public,
260
271
  )
261
272
 
273
+ # Surface configure-repo.sh diagnostics (e.g. Pro-gated environment/ruleset
274
+ # skips for private repos) on stderr, so they aren't swallowed by the runner
275
+ # and stdout stays clean for --json consumers.
276
+ configure_output = apply_result.get("configure_output")
277
+ if configure_output:
278
+ emit_diagnostic(configure_output)
279
+
262
280
  # Register in the ledger idempotently.
263
281
  ledger_written = new_ledger != ledger_text
264
282
  if ledger_written:
@@ -272,6 +290,7 @@ def _handle(args: argparse.Namespace) -> None:
272
290
  "repo": apply_result["repo"],
273
291
  "clone_dest": apply_result["clone_dest"],
274
292
  "pushed": apply_result["pushed"],
293
+ "private": not args.public,
275
294
  "command": plan["command"],
276
295
  "pkg": plan["pkg"],
277
296
  "dist": plan["dist"],
@@ -293,6 +312,7 @@ def _render_dry_run(result: dict) -> str:
293
312
  f" template : {result['template']}",
294
313
  f" agent : {result['agent']}",
295
314
  f" backend : {result['backend']}",
315
+ f" visibility : {'private' if result.get('private') else 'public'}",
296
316
  f" clone dest : {result['clone_dest']}",
297
317
  f" repo token : {plan['repo_token']} (identity: README, culture.yaml, seed, URL)",
298
318
  f" command : {plan['command']}",
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "guild-cli"
3
- version = "0.10.4"
3
+ version = "0.11.0"
4
4
  description = "guildmaster — an agent and CLI that manages skills for the AgentCulture mesh."
5
5
  readme = "README.md"
6
6
  license = "Apache-2.0"
@@ -317,10 +317,13 @@ def test_create_dry_run_explicit_owner_not_prefixed(tmp_path, monkeypatch, capsy
317
317
  class _FakeRunner:
318
318
  """Records every command issued, returns configurable per-command results."""
319
319
 
320
- def __init__(self, *, repo_exists: bool = False, auth_ok: bool = True):
320
+ def __init__(
321
+ self, *, repo_exists: bool = False, auth_ok: bool = True, configure_stderr: str = ""
322
+ ):
321
323
  self.calls: list[tuple[list[str], dict]] = []
322
324
  self._repo_exists = repo_exists
323
325
  self._auth_ok = auth_ok
326
+ self._configure_stderr = configure_stderr
324
327
 
325
328
  def __call__(self, cmd: list[str], *, cwd: str | None = None) -> RunResult:
326
329
  self.calls.append((list(cmd), {"cwd": cwd}))
@@ -375,7 +378,7 @@ class _FakeRunner:
375
378
 
376
379
  # configure-repo.sh
377
380
  if "configure-repo.sh" in " ".join(str(a) for a in argv):
378
- return RunResult(returncode=0)
381
+ return RunResult(returncode=0, stderr=self._configure_stderr)
379
382
 
380
383
  # git -C ... add / commit / push
381
384
  if argv[:1] == ["git"] and "-C" in argv:
@@ -440,6 +443,145 @@ def test_create_apply_full_command_sequence(tmp_path, monkeypatch, capsys):
440
443
  assert poll_idx < clone_idx, f"populate-poll must precede clone; got {issued}"
441
444
 
442
445
 
446
+ def _create_argv(workspace: Path, *extra: str) -> list[str]:
447
+ """Shared argv for the visibility apply tests."""
448
+ return [
449
+ "create",
450
+ "--agent",
451
+ "newsib",
452
+ "--desc",
453
+ "A new sibling.",
454
+ "--workspace-root",
455
+ str(workspace),
456
+ *extra,
457
+ "--apply",
458
+ ]
459
+
460
+
461
+ def _gh_repo_create_cmd(runner: "_FakeRunner") -> list[str]:
462
+ """Return the argv list of the single ``gh repo create`` call."""
463
+ return next(
464
+ cmd
465
+ for cmd, _ in runner.calls
466
+ if cmd[:3] == ["gh", "repo", "create"] and "--template" in cmd
467
+ )
468
+
469
+
470
+ def test_create_apply_defaults_to_private(tmp_path, monkeypatch):
471
+ """Without --public, the repo is created --private (the new default)."""
472
+ root = _seed(tmp_path)
473
+ workspace = tmp_path / "ws"
474
+ workspace.mkdir()
475
+ monkeypatch.chdir(root)
476
+
477
+ runner = _FakeRunner()
478
+ import guild.cli._commands._provision_template as _prov
479
+
480
+ monkeypatch.setattr(_prov, "default_runner", runner)
481
+
482
+ rc = main(_create_argv(workspace))
483
+ assert rc == 0
484
+
485
+ create_cmd = _gh_repo_create_cmd(runner)
486
+ assert "--private" in create_cmd
487
+ assert "--public" not in create_cmd
488
+
489
+
490
+ def test_create_apply_public_flag(tmp_path, monkeypatch):
491
+ """--public creates the repo --public (and never --private)."""
492
+ root = _seed(tmp_path)
493
+ workspace = tmp_path / "ws"
494
+ workspace.mkdir()
495
+ monkeypatch.chdir(root)
496
+
497
+ runner = _FakeRunner()
498
+ import guild.cli._commands._provision_template as _prov
499
+
500
+ monkeypatch.setattr(_prov, "default_runner", runner)
501
+
502
+ rc = main(_create_argv(workspace, "--public"))
503
+ assert rc == 0
504
+
505
+ create_cmd = _gh_repo_create_cmd(runner)
506
+ assert "--public" in create_cmd
507
+ assert "--private" not in create_cmd
508
+
509
+
510
+ def test_create_dry_run_reports_visibility(tmp_path, monkeypatch, capsys):
511
+ """The dry-run render surfaces the chosen visibility (private default / public opt-in)."""
512
+ root = _seed(tmp_path)
513
+ monkeypatch.chdir(root)
514
+ monkeypatch.setattr(subprocess, "run", _never_called)
515
+ monkeypatch.setattr(socket, "getaddrinfo", _never_called)
516
+
517
+ assert main(["create", "--agent", "newsib", "--desc", "X"]) == 0
518
+ assert "visibility : private" in capsys.readouterr().out
519
+
520
+ assert main(["create", "--agent", "newsib", "--desc", "X", "--public"]) == 0
521
+ assert "visibility : public" in capsys.readouterr().out
522
+
523
+
524
+ def test_create_apply_public_json_payload(tmp_path, monkeypatch, capsys):
525
+ """The --json apply payload reports visibility: --public ⇒ private False."""
526
+ root = _seed(tmp_path)
527
+ workspace = tmp_path / "ws"
528
+ workspace.mkdir()
529
+ monkeypatch.chdir(root)
530
+
531
+ runner = _FakeRunner()
532
+ import guild.cli._commands._provision_template as _prov
533
+
534
+ monkeypatch.setattr(_prov, "default_runner", runner)
535
+
536
+ rc = main(_create_argv(workspace, "--public", "--json"))
537
+ assert rc == 0
538
+
539
+ payload = json.loads(capsys.readouterr().out)
540
+ assert payload["private"] is False
541
+
542
+
543
+ def test_create_apply_surfaces_configure_warnings_on_stderr(tmp_path, monkeypatch, capsys):
544
+ """configure-repo.sh Pro-gate skip warnings reach the operator's stderr, and
545
+ stdout stays pure JSON under --json (the runner must not swallow them)."""
546
+ root = _seed(tmp_path)
547
+ workspace = tmp_path / "ws"
548
+ workspace.mkdir()
549
+ monkeypatch.chdir(root)
550
+
551
+ warning = " ⚠ skipped ruleset 'Protect main' — requires GitHub Pro/Team for private repos"
552
+ runner = _FakeRunner(configure_stderr=warning + "\n")
553
+ import guild.cli._commands._provision_template as _prov
554
+
555
+ monkeypatch.setattr(_prov, "default_runner", runner)
556
+
557
+ rc = main(_create_argv(workspace, "--json"))
558
+ assert rc == 0
559
+
560
+ captured = capsys.readouterr()
561
+ # stdout is still valid JSON (the warning did NOT leak onto it).
562
+ payload = json.loads(captured.out)
563
+ assert payload["applied"] is True
564
+ # the skip warning is surfaced as a diagnostic on stderr.
565
+ assert "skipped ruleset 'Protect main'" in captured.err
566
+
567
+
568
+ def test_create_apply_no_configure_warnings_keeps_stderr_quiet(tmp_path, monkeypatch, capsys):
569
+ """A clean configure-repo run (no Pro-gate skips) emits nothing extra to stderr."""
570
+ root = _seed(tmp_path)
571
+ workspace = tmp_path / "ws"
572
+ workspace.mkdir()
573
+ monkeypatch.chdir(root)
574
+
575
+ runner = _FakeRunner() # no configure_stderr
576
+ import guild.cli._commands._provision_template as _prov
577
+
578
+ monkeypatch.setattr(_prov, "default_runner", runner)
579
+
580
+ rc = main(_create_argv(workspace, "--json"))
581
+ assert rc == 0
582
+ assert capsys.readouterr().err == ""
583
+
584
+
443
585
  def test_wait_for_template_polls_until_populated():
444
586
  """The repo is empty (409) for a few polls, then the template lands."""
445
587
  import guild.cli._commands._provision_template as _prov
@@ -179,7 +179,7 @@ wheels = [
179
179
 
180
180
  [[package]]
181
181
  name = "guild-cli"
182
- version = "0.10.4"
182
+ version = "0.11.0"
183
183
  source = { editable = "." }
184
184
  dependencies = [
185
185
  { name = "pyyaml" },
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes