action-platform 0.1.2__tar.gz → 0.2.0__tar.gz

{action_platform-0.1.2 → action_platform-0.2.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: action-platform
-Version: 0.1.2
-Summary: From idea to production in one command: scaffold, CI, release and deploy on any stack and cloud, with git-flow and Conventional Commits enforced and an MCP server for AI agents.
+Version: 0.2.0
+Summary: Your platform team, as a CLI.
 License: Apache License
                                     Version 2.0, January 2004
                                  http://www.apache.org/licenses/
@@ -248,7 +248,7 @@ Description-Content-Type: text/markdown
 </p>
 
 <p align="center">
-  <strong>From idea to production in one command — on any stack, on any cloud.</strong>
+  <strong>Your platform team, as a CLI.</strong>
 </p>
 
 <p align="center">
@@ -321,13 +321,64 @@ action-platform branch feature 42 login           # develop (or main) → pull
 action-platform branch hotfix PROJ-7              # from main/master
 action-platform gitflow                           # audit current branch + commits; --install-hooks
 action-platform pr [--draft] [--dry-run]          # PR for the current branch: target from git-flow, body from commits
-action-platform release patch                     # bump, changelog, tag, GitHub release
+action-platform release patch                     # bump, changelog, tag, GitHub release; off main/master → X.Y.Z-rc.N pre-release
 action-platform deploy --stage prod
 action-platform rollback
 action-platform diagnose
 action-platform destroy
 ```
 
+## Git-flow, enforced
+
+Every project follows the same flow. Git hooks refuse the wrong move before it exists; CI refuses it on the pull request; the CLI and the MCP tools guide the right one.
+
+```mermaid
+gitGraph
+    commit id: "chore: bootstrap"
+    branch develop
+    checkout develop
+    commit id: "chore(release): 0.3.2-rc.1" tag: "v0.3.2-rc.1"
+    branch feature/42-login
+    checkout feature/42-login
+    commit id: "feat(login): form"
+    commit id: "test(login): cover form"
+    checkout develop
+    merge feature/42-login id: "PR #1 → develop"
+    branch release/0.3.2
+    checkout release/0.3.2
+    commit id: "chore(release): 0.3.2-rc.2" tag: "v0.3.2-rc.2"
+    checkout main
+    merge release/0.3.2 id: "PR #2 → main"
+    commit id: "chore(release): 0.3.2" tag: "v0.3.2"
+    checkout develop
+    merge main id: "back-merge"
+    checkout main
+    branch hotfix/PROJ-7
+    checkout hotfix/PROJ-7
+    commit id: "fix(auth): expiry"
+    checkout main
+    merge hotfix/PROJ-7 id: "PR #3 → main"
+    commit id: "chore(release): 0.3.3" tag: "v0.3.3"
+    checkout develop
+    merge main id: "back-merge hotfix"
+```
+
+| Branch | Starts from | Merges into | Release |
+|--------|-------------|-------------|---------|
+| `feature/<code>`, `bugfix/…`, `chore/…`, `docs/…`, `refactor/…`, `test/…`, `ci/…`, `perf/…` | `develop` (or the default branch when there is no `develop`) | `develop` | `X.Y.Z-rc.N` pre-release |
+| `release/<version>` | `develop` | `main` and `develop` | `X.Y.Z-rc.N` until merged |
+| `hotfix/<code>` | `main` | `main` and `develop` | `X.Y.Z-rc.N` until merged |
+| `main` / `master` | — | — | stable `X.Y.Z` → PyPI / npm / … |
+
+Rules the hooks and CI apply: branch names are `<kind>/<code>[-slug]`; commits are [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/); no direct commits on `main`, `master` or `develop` except `chore(release):`, `chore(platform):` and the bootstrap commit; a pull request may only target what the table allows.
+
+```bash
+action-platform branch feature 42 login     # develop → pull → feature/42-login → push
+action-platform gitflow                     # audit branch + commits
+action-platform pr                          # target and body from the rules and the commits
+action-platform release patch               # rc off main, stable on main
+```
+
 Everything a project needs is declared in one file:
 
 ```toml
@@ -336,6 +387,7 @@ name = "orders"
 type = "web"
 stack = "python"
 template = "fastapi"
+ci = "github"
 language = "python"
 
 [source_host]
@@ -351,7 +403,7 @@ postgres = "aws-rds"
 
 ## Use it from an AI client
 
-The platform ships as an MCP server. Claude Code, Codex, Cursor — anything that speaks MCP — gets `list_matrix`, `init_project`, `cloud_set`, `service_add`, `release`, `deploy`, `diagnose` as tools, plus skills that make the agent preview and ask before pushing or deploying.
+The platform ships as an MCP server. Claude Code, Codex, Cursor — anything that speaks MCP — gets 17 tools (`list_matrix`, `init_project`, `install_platform`, `start_branch`, `gitflow_audit`, `propose_pull_request`, `release`, `deploy`, `diagnose`, …), 6 prompts that put them in the right order (`new_service`, `ship_feature`, `cut_release`, `deploy_project`, `adopt_repository`, `fix_gitflow`) and 12 skills that make the agent preview and ask before anything leaves the machine.
 
 ```bash
 pip install "action-platform[mcp]"

{action_platform-0.1.2 → action_platform-0.2.0}/README.md

@@ -3,7 +3,7 @@
 </p>
 
 <p align="center">
-  <strong>From idea to production in one command — on any stack, on any cloud.</strong>
+  <strong>Your platform team, as a CLI.</strong>
 </p>
 
 <p align="center">
@@ -76,13 +76,64 @@ action-platform branch feature 42 login           # develop (or main) → pull
 action-platform branch hotfix PROJ-7              # from main/master
 action-platform gitflow                           # audit current branch + commits; --install-hooks
 action-platform pr [--draft] [--dry-run]          # PR for the current branch: target from git-flow, body from commits
-action-platform release patch                     # bump, changelog, tag, GitHub release
+action-platform release patch                     # bump, changelog, tag, GitHub release; off main/master → X.Y.Z-rc.N pre-release
 action-platform deploy --stage prod
 action-platform rollback
 action-platform diagnose
 action-platform destroy
 ```
 
+## Git-flow, enforced
+
+Every project follows the same flow. Git hooks refuse the wrong move before it exists; CI refuses it on the pull request; the CLI and the MCP tools guide the right one.
+
+```mermaid
+gitGraph
+    commit id: "chore: bootstrap"
+    branch develop
+    checkout develop
+    commit id: "chore(release): 0.3.2-rc.1" tag: "v0.3.2-rc.1"
+    branch feature/42-login
+    checkout feature/42-login
+    commit id: "feat(login): form"
+    commit id: "test(login): cover form"
+    checkout develop
+    merge feature/42-login id: "PR #1 → develop"
+    branch release/0.3.2
+    checkout release/0.3.2
+    commit id: "chore(release): 0.3.2-rc.2" tag: "v0.3.2-rc.2"
+    checkout main
+    merge release/0.3.2 id: "PR #2 → main"
+    commit id: "chore(release): 0.3.2" tag: "v0.3.2"
+    checkout develop
+    merge main id: "back-merge"
+    checkout main
+    branch hotfix/PROJ-7
+    checkout hotfix/PROJ-7
+    commit id: "fix(auth): expiry"
+    checkout main
+    merge hotfix/PROJ-7 id: "PR #3 → main"
+    commit id: "chore(release): 0.3.3" tag: "v0.3.3"
+    checkout develop
+    merge main id: "back-merge hotfix"
+```
+
+| Branch | Starts from | Merges into | Release |
+|--------|-------------|-------------|---------|
+| `feature/<code>`, `bugfix/…`, `chore/…`, `docs/…`, `refactor/…`, `test/…`, `ci/…`, `perf/…` | `develop` (or the default branch when there is no `develop`) | `develop` | `X.Y.Z-rc.N` pre-release |
+| `release/<version>` | `develop` | `main` and `develop` | `X.Y.Z-rc.N` until merged |
+| `hotfix/<code>` | `main` | `main` and `develop` | `X.Y.Z-rc.N` until merged |
+| `main` / `master` | — | — | stable `X.Y.Z` → PyPI / npm / … |
+
+Rules the hooks and CI apply: branch names are `<kind>/<code>[-slug]`; commits are [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/); no direct commits on `main`, `master` or `develop` except `chore(release):`, `chore(platform):` and the bootstrap commit; a pull request may only target what the table allows.
+
+```bash
+action-platform branch feature 42 login     # develop → pull → feature/42-login → push
+action-platform gitflow                     # audit branch + commits
+action-platform pr                          # target and body from the rules and the commits
+action-platform release patch               # rc off main, stable on main
+```
+
 Everything a project needs is declared in one file:
 
 ```toml
@@ -91,6 +142,7 @@ name = "orders"
 type = "web"
 stack = "python"
 template = "fastapi"
+ci = "github"
 language = "python"
 
 [source_host]
@@ -106,7 +158,7 @@ postgres = "aws-rds"
 
 ## Use it from an AI client
 
-The platform ships as an MCP server. Claude Code, Codex, Cursor — anything that speaks MCP — gets `list_matrix`, `init_project`, `cloud_set`, `service_add`, `release`, `deploy`, `diagnose` as tools, plus skills that make the agent preview and ask before pushing or deploying.
+The platform ships as an MCP server. Claude Code, Codex, Cursor — anything that speaks MCP — gets 17 tools (`list_matrix`, `init_project`, `install_platform`, `start_branch`, `gitflow_audit`, `propose_pull_request`, `release`, `deploy`, `diagnose`, …), 6 prompts that put them in the right order (`new_service`, `ship_feature`, `cut_release`, `deploy_project`, `adopt_repository`, `fix_gitflow`) and 12 skills that make the agent preview and ask before anything leaves the machine.
 
 ```bash
 pip install "action-platform[mcp]"

{action_platform-0.1.2 → action_platform-0.2.0}/action_platform/__init__.py

@@ -1,6 +1,6 @@
 """Action Platform __init__ module."""
 
-__version__ = "0.1.0"
+__version__ = "0.1.2"
 __description__ = "🛠️ Action Platform padroniza init, release e deploy."
 
 from .core.config import Config

{action_platform-0.1.2 → action_platform-0.2.0}/action_platform/cli/commands/install.py

@@ -17,7 +17,11 @@ def run(
     language: str | None = typer.Option(
         None, "--language", help="python, go, node, php, java, rust (default: detected)"
     ),
-    ci: str = typer.Option("github", "--ci", help="github, gitlab, jenkins"),
+    ci: str | None = typer.Option(
+        None,
+        "--ci",
+        help="github, gitlab, jenkins (default: platform.toml, else github)",
+    ),
     dry_run: bool = typer.Option(False, "--dry-run", help="Show what would be created"),
 ) -> None:
     """Install the platform in this repository: platform.toml, code quality, CI files (never overwritten) and git hooks into .git/hooks (always refreshed)."""

{action_platform-0.1.2 → action_platform-0.2.0}/action_platform/cli/commands/release.py

@@ -14,9 +14,14 @@ from action_platform.logging import logger
 def run(
     level: str = typer.Argument("patch", help="patch | minor | major | X.Y.Z"),
     dry_run: bool = typer.Option(False, "--dry-run"),
+    rc: bool | None = typer.Option(
+        None,
+        "--rc/--stable",
+        help="Pre-release X.Y.Z-rc.N (default: rc off main/master, stable on them)",
+    ),
 ) -> None:
-    """Bump version, generate changelog, tag, and publish release."""
+    """Bump version, generate changelog, tag, and publish release. Off main/master it cuts an rc."""
     config = Config.from_toml(Path.cwd() / "platform.toml")
     tool = ActionPlatform(config=config)
-    ctx = tool.release(level=level, dry_run=dry_run)
+    ctx = tool.release(level=level, dry_run=dry_run, prerelease=rc)
     logger.info("release done: %s", ctx.next_version)

{action_platform-0.1.2 → action_platform-0.2.0}/action_platform/core/action_platform.py

@@ -34,8 +34,15 @@ class ActionPlatform:
         self.config = config or Config()
         self.repo_root = repo_root or Path.cwd()
 
-    def release(self, level: str = "patch", dry_run: bool = False) -> Context:
-        return pipeline.release(self.config, level, self.repo_root, dry_run=dry_run)
+    def release(
+        self,
+        level: str = "patch",
+        dry_run: bool = False,
+        prerelease: bool | None = None,
+    ) -> Context:
+        return pipeline.release(
+            self.config, level, self.repo_root, dry_run=dry_run, prerelease=prerelease
+        )
 
     def deploy(
         self, target: str | None = None, dry_run: bool = False, stage: str | None = None

{action_platform-0.1.2 → action_platform-0.2.0}/action_platform/core/git.py

@@ -96,3 +96,20 @@ def add_remote(url: str, cwd: Path, remote: str = "origin") -> None:
 
 def push_upstream(branch: str, cwd: Path, remote: str = "origin") -> None:
     run(["push", "-u", remote, branch], cwd=cwd)
+
+
+def tags(cwd: Path | None = None) -> list[str]:
+    out = run(["tag", "--list"], cwd=cwd)
+
+    return [t for t in out.split("\n") if t]
+
+
+def remote_tag_exists(
+    tag: str, cwd: Path | None = None, remote: str = "origin"
+) -> bool:
+    try:
+        out = run(["ls-remote", "--tags", remote, tag], cwd=cwd)
+    except subprocess.CalledProcessError:
+        return False
+
+    return bool(out.strip())

{action_platform-0.1.2 → action_platform-0.2.0}/action_platform/core/install.py

@@ -73,7 +73,7 @@ def install(
     root: Path,
     type_: str = "web",
     language: str | None = None,
-    ci: str = "github",
+    ci: str | None = None,
     dry_run: bool = False,
 ) -> Plan:
     root = root.resolve()
@@ -81,6 +81,7 @@ def install(
     if not (root / ".git").exists():
         raise InstallError(f"{root} is not a git repository")
 
+    ci = ci or _existing_ci(root) or "github"
     language = language or detect_language(root)
 
     if language is None:
@@ -96,7 +97,9 @@ def install(
     source = _source_leaf(repo, matrix, language)
     plan = Plan(root=root, language=language, type=type_, ci=ci)
 
-    _write(plan, settings.CONFIG_FILE, _platform_toml(root, type_, language), dry_run)
+    _write(
+        plan, settings.CONFIG_FILE, _platform_toml(root, type_, language, ci), dry_run
+    )
     _write(plan, settings.LAST_VERSION_FILE, "0.1.0\n", dry_run)
     _write(plan, "AGENTS.md", AGENTS, dry_run)
 
@@ -133,16 +136,28 @@ def _language_of(leaf_dir: Path) -> str:
         return ""
 
 
-def _platform_toml(root: Path, type_: str, language: str) -> str:
+def _existing_ci(root: Path) -> str | None:
+    path = root / settings.CONFIG_FILE
+
+    if not path.exists():
+        return None
+
+    import tomllib
+
+    try:
+        return tomllib.loads(path.read_text()).get("project", {}).get("ci") or None
+    except tomllib.TOMLDecodeError:
+        return None
+
+
+def _platform_toml(root: Path, type_: str, language: str, ci: str) -> str:
     remote = git.remote_url(cwd=root)
     repo = ""
 
     if "github.com" in remote:
         repo = remote.split("github.com", 1)[1].strip(":/").removesuffix(".git")
 
-    text = (
-        f'[project]\nname = "{root.name}"\ntype = "{type_}"\nlanguage = "{language}"\n'
-    )
+    text = f'[project]\nname = "{root.name}"\ntype = "{type_}"\nci = "{ci}"\nlanguage = "{language}"\n'
 
     if repo:
         text += f'\n[source_host]\nkind = "github"\nrepo = "{repo}"\n'

{action_platform-0.1.2 → action_platform-0.2.0}/action_platform/core/pipeline.py

@@ -27,6 +27,24 @@ def build_context(
     )
 
 
+def _next_version(current: str, level: str, prerelease: bool, repo_root: Path) -> str:
+    """Stable: plain bump. Pre-release: bump the stable base (or keep it when already on an rc) and add -rc.N."""
+    base = versioning.strip_pre(current)
+    _, _, _, pre = versioning.parse(current)
+
+    if not prerelease:
+        return versioning.bump(base, level)
+
+    if versioning.SEMVER_RE.match(level):
+        target = versioning.strip_pre(level)
+    elif pre:
+        target = base
+    else:
+        target = versioning.bump(base, level)
+
+    return versioning.next_rc(target, git.tags(cwd=repo_root))
+
+
 def _targets(config: Config, target_name: str | None):
     targets = (
         config.deploy
@@ -44,15 +62,35 @@ def _targets(config: Config, target_name: str | None):
 
 
 def release(
-    config: Config, level: str, repo_root: Path, dry_run: bool = False
+    config: Config,
+    level: str,
+    repo_root: Path,
+    dry_run: bool = False,
+    prerelease: bool | None = None,
 ) -> Context:
     ctx = build_context(config, repo_root, dry_run=dry_run)
 
     if not git.is_clean(cwd=repo_root):
         raise ReleaseError("working tree is dirty")
 
-    ctx.next_version = versioning.bump(ctx.current_version, level)
-    logger.info("bump %s -> %s", ctx.current_version, ctx.next_version)
+    if prerelease is None:
+        prerelease = ctx.branch not in {"main", "master"}
+
+    ctx.next_version = _next_version(ctx.current_version, level, prerelease, repo_root)
+    tag = f"v{ctx.next_version}"
+
+    if ctx.next_version == ctx.current_version:
+        raise ReleaseError(f"{ctx.current_version} is already the current version")
+
+    if tag in git.tags(cwd=repo_root) or git.remote_tag_exists(tag, cwd=repo_root):
+        raise ReleaseError(f"tag {tag} already exists")
+
+    logger.info(
+        "bump %s -> %s%s",
+        ctx.current_version,
+        ctx.next_version,
+        " (pre-release)" if prerelease else "",
+    )
 
     commits = git.commits_since(git.latest_tag(cwd=repo_root), cwd=repo_root)
     ctx.changelog = changelog.render(ctx.next_version, commits)
@@ -63,17 +101,20 @@ def release(
 
     versioning.write(repo_root / settings.LAST_VERSION_FILE, ctx.next_version)
     changelog.prepend(repo_root / settings.CHANGELOG_FILE, ctx.changelog)
+    synced = versioning.sync_files(repo_root, ctx.next_version)
 
-    tag = f"v{ctx.next_version}"
-
-    git.add([settings.LAST_VERSION_FILE, settings.CHANGELOG_FILE], cwd=repo_root)
+    git.add(
+        [settings.LAST_VERSION_FILE, settings.CHANGELOG_FILE, *synced], cwd=repo_root
+    )
     git.commit(f"chore(release): {ctx.next_version}", cwd=repo_root)
     git.create_tag(tag, tag, cwd=repo_root)
     git.push(cwd=repo_root)
     git.push_tag(tag, cwd=repo_root)
 
     if config.source_host:
-        config.source_host.create_release(ctx, tag=tag, notes=ctx.changelog)
+        config.source_host.create_release(
+            ctx, tag=tag, notes=ctx.changelog, prerelease=prerelease
+        )
 
     for runner in config.ci:
         run = runner.trigger(

action_platform-0.2.0/action_platform/core/versioning.py

@@ -0,0 +1,98 @@
+"""Semver bump + LAST_VERSION management."""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+from action_platform.core.exception import ActionPlatformError
+
+SEMVER_RE = re.compile(r"^(\d+)\.(\d+)\.(\d+)(?:-([\w.]+))?$")
+
+
+def parse(version: str) -> tuple[int, int, int, str | None]:
+    match = SEMVER_RE.match(version.strip().lstrip("v"))
+    if not match:
+        raise ActionPlatformError(f"Invalid semver: {version!r}")
+    major, minor, patch, pre = match.groups()
+    return int(major), int(minor), int(patch), pre
+
+
+def format(major: int, minor: int, patch: int, pre: str | None = None) -> str:
+    base = f"{major}.{minor}.{patch}"
+    return f"{base}-{pre}" if pre else base
+
+
+def bump(version: str, level: str) -> str:
+    major, minor, patch, _ = parse(version)
+    if level == "major":
+        return format(major + 1, 0, 0)
+    if level == "minor":
+        return format(major, minor + 1, 0)
+    if level == "patch":
+        return format(major, minor, patch + 1)
+    parse(level)
+    return level
+
+
+def strip_pre(version: str) -> str:
+    major, minor, patch, _ = parse(version)
+
+    return format(major, minor, patch)
+
+
+def next_rc(base: str, existing_tags: list[str]) -> str:
+    """`base` plus the next -rc.N not yet tagged."""
+    prefix = f"v{base}-rc."
+    taken = [
+        int(t[len(prefix) :])
+        for t in existing_tags
+        if t.startswith(prefix) and t[len(prefix) :].isdigit()
+    ]
+
+    return f"{base}-rc.{max(taken, default=0) + 1}"
+
+
+def read(path: Path) -> str:
+    return path.read_text().strip() if path.exists() else "0.0.0"
+
+
+def write(path: Path, version: str) -> None:
+    path.write_text(f"{version}\n")
+
+
+VERSION_PATTERNS = {
+    "pyproject.toml": re.compile(r'^(version\s*=\s*")[^"]*(")', re.M),
+    "package.json": re.compile(r'^(\s*"version":\s*")[^"]*(")', re.M),
+    "Cargo.toml": re.compile(r'^(version\s*=\s*")[^"]*(")', re.M),
+    "composer.json": re.compile(r'^(\s*"version":\s*")[^"]*(")', re.M),
+}
+INIT_RE = re.compile(r'^(__version__\s*=\s*")[^"]*(")', re.M)
+
+
+def sync_files(root: Path, version: str) -> list[str]:
+    """Write `version` into every manifest and top-level `__version__` found. Returns the files touched."""
+    touched = []
+
+    for name, pattern in VERSION_PATTERNS.items():
+        path = root / name
+
+        if not path.exists():
+            continue
+
+        text = path.read_text()
+        updated = pattern.sub(rf"\g<1>{version}\g<2>", text)
+
+        if updated != text:
+            path.write_text(updated)
+            touched.append(name)
+
+    for init in sorted(root.glob("*/__init__.py")):
+        text = init.read_text()
+        updated = INIT_RE.sub(rf"\g<1>{version}\g<2>", text)
+
+        if updated != text:
+            init.write_text(updated)
+            touched.append(str(init.relative_to(root)))
+
+    return touched

action_platform-0.2.0/action_platform/mcp/prompts.py

@@ -0,0 +1,136 @@
+"""Prompts that put the tools in the order a platform task actually needs.
+
+The costly mistakes live in the order: pushing before the user saw the
+repository name, deploying before preflight, opening a pull request from a
+branch that fails git-flow, releasing from the wrong branch.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+
+def register(mcp: Any) -> None:
+    @mcp.prompt(
+        title="New service",
+        description="Scaffold a service from the templates, add its cloud and dependencies, push on approval.",
+    )
+    def new_service(
+        name: str = "", stack: str = "python", cloud: str = "", services: str = ""
+    ) -> str:
+        return (
+            "Create a new service on the platform.\n\n"
+            f"Name: {name or 'ask the user'}. Stack: {stack}. Cloud: {cloud or 'none yet'}. "
+            f"Dependencies: {services or 'none'}.\n\n"
+            "1. Call list_matrix and pick the `web` template for the stack; when "
+            "several exist, ask which unless the user named one.\n"
+            "2. Call init_project with type=web, the stack, the name and ci=github "
+            "unless the user uses GitLab or Jenkins. Pass `cloud` only when one was named.\n"
+            "3. For each dependency call service_add; pick the provider from context "
+            "(docker locally, aws-* when the cloud is AWS).\n"
+            "4. Show project_info and the files that matter: platform.toml, DEPLOY.md, "
+            "requirements/ when a cloud was added.\n"
+            "5. Say the repository that push_project would create — owner/name, public "
+            "or private — and wait for a yes before calling it.\n\n"
+            "Never call push_project in the same turn as init_project."
+        )
+
+    @mcp.prompt(
+        title="Ship a feature",
+        description="Start a git-flow branch, work, audit, and open the pull request on approval.",
+    )
+    def ship_feature(issue: str = "", summary: str = "") -> str:
+        return (
+            "Take a change from idea to pull request under git-flow.\n\n"
+            f"Issue or ticket: {issue or 'ask the user — a branch needs a code'}. "
+            f"Summary: {summary or 'ask what the change is'}.\n\n"
+            "1. Decide the kind from the intent: new capability → feature, bug in "
+            "development → bugfix, production incident → hotfix, everything else by "
+            "its Conventional Commit type (chore, docs, refactor, test, ci, perf). "
+            "gitflow_rules lists them.\n"
+            "2. Call start_branch with the kind, the code and a two-word slug. It picks "
+            "develop or main as base; never commit on those directly.\n"
+            "3. Make the change in small Conventional Commits: `type(scope): description`, "
+            "one concern per commit, files staged explicitly.\n"
+            "4. Call gitflow_audit. Fix every problem it lists before going on.\n"
+            "5. Call propose_pull_request and show head → base, title and body.\n"
+            "6. On approval call open_pull_request. For release or hotfix branches, "
+            "remind the user a second pull request into develop follows the merge."
+        )
+
+    @mcp.prompt(
+        title="Cut a release",
+        description="Preview the next version and changelog, publish only on approval; rc off main.",
+    )
+    def cut_release(level: str = "patch") -> str:
+        return (
+            f"Cut a {level} release.\n\n"
+            "1. Call project_info and gitflow_audit; a dirty tree or a branch that "
+            "fails git-flow stops here — say what to fix.\n"
+            "2. Call release with dry_run=true. Report the current and next version "
+            "and the changelog. On main/master the version is stable; on any other "
+            "branch it is X.Y.Z-rc.N and the release is marked pre-release — say which "
+            "case applies and why.\n"
+            "3. An empty changelog means the commits are not Conventional Commits; "
+            "stop and explain instead of releasing an empty entry.\n"
+            "4. On approval call release again with dry_run=false and report the tag "
+            "and the release URL. Mention that the publish workflow runs from the "
+            "release (PyPI, npm, Packagist… for stable; the test index for rc)."
+        )
+
+    @mcp.prompt(
+        title="Deploy",
+        description="Preflight, deploy on approval, verify with diagnose.",
+    )
+    def deploy_project(stage: str = "") -> str:
+        return (
+            "Deploy the current version.\n\n"
+            f"Stage: {stage or 'from the branch — main/master is prod, anything else dev'}.\n\n"
+            "1. Call project_info; without a [deploy] target offer cloud_set and stop.\n"
+            "2. Call deploy with dry_run=true. That is preflight: tooling, template "
+            "validation, credentials. Relay any error verbatim; 'no provider installed' "
+            "means the target's provider package is missing.\n"
+            "3. Say the target, stage and version that would go live and wait for a yes.\n"
+            "4. Call deploy with dry_run=false, then diagnose. Report status and URL.\n"
+            "5. If diagnose is not ok, propose rollback — and confirm before calling it."
+        )
+
+    @mcp.prompt(
+        title="Adopt an existing repository",
+        description="Bring a repo that was not generated by the platform onto it, without touching its code.",
+    )
+    def adopt_repository(ci: str = "github") -> str:
+        return (
+            "Install the platform in an existing repository.\n\n"
+            f"CI: {ci}.\n\n"
+            "1. Call install_platform with dry_run=true. Show created and kept: "
+            "nothing that exists is overwritten, and app code and deploy files are "
+            "not touched.\n"
+            "2. Explain what changes for the team from that moment: Conventional "
+            "Commits, work on <kind>/<code> branches, main/develop refuse direct "
+            "commits. If the repo used another commit style, say so before proceeding.\n"
+            "3. On approval call install_platform with dry_run=false. Hooks are "
+            "installed into .git/hooks; every other clone runs install_hooks once.\n"
+            "4. Suggest the commit `chore(platform): install action-platform` on the "
+            "default branch — one of the exceptions the hooks allow — then gitflow_audit."
+        )
+
+    @mcp.prompt(
+        title="Fix git-flow",
+        description="Diagnose and repair a branch that violates git-flow before it reaches a pull request.",
+    )
+    def fix_gitflow() -> str:
+        return (
+            "Repair git-flow violations on the current branch.\n\n"
+            "1. Call gitflow_audit and gitflow_rules. Map each problem to a fix:\n"
+            "   - wrong branch name → `git branch -m <kind>/<code>-slug`\n"
+            "   - commits on main/develop → start_branch from the same base, "
+            "cherry-pick them, reset the protected branch to origin\n"
+            "   - non-conventional messages → `git commit --amend` for the last one, "
+            "`git rebase -i` to reword older ones\n"
+            "2. Every fix rewrites history: show the exact commands and the new "
+            "messages, and wait for a yes. Never rewrite commits already pushed to a "
+            "shared branch without saying so.\n"
+            "3. If violations got through, the hooks are missing: call install_hooks.\n"
+            "4. Re-run gitflow_audit until it reports ok."
+        )

{action_platform-0.1.2 → action_platform-0.2.0}/action_platform/mcp/server.py

@@ -8,6 +8,7 @@ from typing import Optional
 from mcp.server.mcpserver import MCPServer
 
 from action_platform import __version__
+from action_platform.mcp import prompts
 from action_platform.mcp.tools import flow, lifecycle, matrix, project
 
 INSTRUCTIONS = """Scaffold, deploy and operate projects on the Action Platform.
@@ -35,6 +36,7 @@ def build() -> MCPServer:
     project.register(mcp)
     flow.register(mcp)
     lifecycle.register(mcp)
+    prompts.register(mcp)
 
     return mcp
 

{action_platform-0.1.2 → action_platform-0.2.0}/action_platform/mcp/tools/lifecycle.py

@@ -45,7 +45,8 @@ def register(mcp: Any) -> None:
         """Bump version, write CHANGELOG, tag, push and publish a release.
 
         Defaults to a dry run. Show the user the next version and changelog,
-        then call again with dry_run=false to publish.
+        then call again with dry_run=false to publish. Off main/master the
+        version becomes X.Y.Z-rc.N and the release is marked pre-release.
         """
         ctx = _tool(project).release(level=level, dry_run=dry_run)
 

{action_platform-0.1.2 → action_platform-0.2.0}/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "action-platform"
-version = "0.1.2"
+version = "0.2.0"
 authors = [
   { name="Fernando Celmer", email="email@fernandocelmer.com" },
 ]
 license = {file = "LICENSE"}
-description = "From idea to production in one command: scaffold, CI, release and deploy on any stack and cloud, with git-flow and Conventional Commits enforced and an MCP server for AI agents."
+description = "Your platform team, as a CLI."
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
@@ -71,8 +71,8 @@ mcp = ["mcp>=2.0"]
 
 [tool.poetry]
 name = "action-platform"
-version = "0.1.2"
-description = "From idea to production in one command: scaffold, CI, release and deploy on any stack and cloud, with git-flow and Conventional Commits enforced and an MCP server for AI agents."
+version = "0.2.0"
+description = "Your platform team, as a CLI."
 authors = ["Fernando Celmer <email@fernandocelmer.com>"]
 readme = "README.md"
 license = "Apache-2.0"

action_platform-0.1.2/action_platform/core/versioning.py

@@ -1,43 +0,0 @@
-"""Semver bump + LAST_VERSION management."""
-
-from __future__ import annotations
-
-import re
-from pathlib import Path
-
-from action_platform.core.exception import ActionPlatformError
-
-SEMVER_RE = re.compile(r"^(\d+)\.(\d+)\.(\d+)(?:-([\w.]+))?$")
-
-
-def parse(version: str) -> tuple[int, int, int, str | None]:
-    match = SEMVER_RE.match(version.strip().lstrip("v"))
-    if not match:
-        raise ActionPlatformError(f"Invalid semver: {version!r}")
-    major, minor, patch, pre = match.groups()
-    return int(major), int(minor), int(patch), pre
-
-
-def format(major: int, minor: int, patch: int, pre: str | None = None) -> str:
-    base = f"{major}.{minor}.{patch}"
-    return f"{base}-{pre}" if pre else base
-
-
-def bump(version: str, level: str) -> str:
-    major, minor, patch, _ = parse(version)
-    if level == "major":
-        return format(major + 1, 0, 0)
-    if level == "minor":
-        return format(major, minor + 1, 0)
-    if level == "patch":
-        return format(major, minor, patch + 1)
-    parse(level)
-    return level
-
-
-def read(path: Path) -> str:
-    return path.read_text().strip() if path.exists() else "0.0.0"
-
-
-def write(path: Path, version: str) -> None:
-    path.write_text(f"{version}\n")