piagentsync 0.0.1rc0__tar.gz

piagentsync-0.0.1rc0/.env.example

@@ -0,0 +1,8 @@
+# piagentsync configuration
+# Copy to .env and fill in values
+
+# Path to your Obsidian vault (git repo)
+PIAGENTSYNC_VAULT_PATH=~/vault
+
+# Path to global OpenCode config
+PIAGENTSYNC_GLOBAL_OPENCODE_PATH=~/.config/opencode

piagentsync-0.0.1rc0/.github/scripts/generate_changelog.py

@@ -0,0 +1,203 @@
+#!/usr/bin/env python3
+"""Generate changelog entry from conventional commits and compute next version.
+
+This script:
+1. Finds the latest stable semantic version tag (vX.Y.Z)
+2. Computes the next version based on the BUMP input (MAJOR/MINOR/PATCH/RC)
+3. Gathers conventional commit messages since that tag
+4. Categorizes and formats them into a changelog entry
+5. Prepends the entry to CHANGELOG.md
+6. Outputs GITHUB_OUTPUT variables: new_version and tag_name
+"""
+
+import os
+import re
+import subprocess
+import sys
+from datetime import datetime
+from pathlib import Path
+
+
+def run_git(*args):
+    """Run a git command and return stdout."""
+    result = subprocess.run(["git"] + list(args), capture_output=True, text=True, check=True)
+    return result.stdout.strip()
+
+
+def get_latest_stable_tag():
+    """Get the latest vX.Y.Z tag (ignoring -rc tags)."""
+    try:
+        tags = run_git("tag", "-l", "v*", "--sort=-v:refname").splitlines()
+    except subprocess.CalledProcessError:
+        return None
+
+    for tag in tags:
+        # Match only pure semver without suffix
+        if re.fullmatch(r"v\d+\.\d+\.\d+", tag):
+            return tag
+    return None
+
+
+def parse_version(tag):
+    """Parse vX.Y.Z into (major, minor, patch)."""
+    if tag is None:
+        return (0, 0, 0)
+    m = re.match(r"v(\d+)\.(\d+)\.(\d+)", tag)
+    if not m:
+        return (0, 0, 0)
+    return tuple(int(x) for x in m.groups())
+
+
+def bump_version(major, minor, patch, bump_type):
+    """Return (new_major, new_minor, new_patch, suffix)."""
+    suffix = ""
+    if bump_type == "MAJOR":
+        major += 1
+        minor = 0
+        patch = 0
+    elif bump_type == "MINOR":
+        minor += 1
+        patch = 0
+    elif bump_type == "PATCH":
+        patch += 1
+    elif bump_type == "RC":
+        patch += 1
+        suffix = "-rc"
+    else:
+        raise ValueError(f"Unknown bump type: {bump_type}")
+    return major, minor, patch, suffix
+
+
+def get_commits_since_tag(tag):
+    """Get commit messages from tag..HEAD (or all if tag is None)."""
+    if tag is None:
+        # All commits reachable from HEAD
+        rev_range = "HEAD"
+    else:
+        rev_range = f"{tag}..HEAD"
+
+    # Get conventional commits; format: <type>(<scope>): <subject>
+    # We'll grab the full subject line (skip body for changelog)
+    log = run_git("log", rev_range, "--pretty=format:%s", "--no-merges")
+    commits = [line.strip() for line in log.splitlines() if line.strip()]
+    return commits
+
+
+def categorize_commits(commits):
+    """Map conventional commit types to changelog headings."""
+    mapping = {
+        "feat": "Added",
+        "fix": "Fixed",
+        "perf": "Performance",
+        "docs": "Documentation",
+        "style": "Style",
+        "refactor": "Refactored",
+        "test": "Tests",
+        "chore": "Chores",
+        "ci": "CI/CD",
+        "build": "Build",
+        "revert": "Reverts",
+    }
+    categories: dict[str, list[str]] = {v: [] for v in mapping.values()}
+    categories["Other"] = []
+
+    for msg in commits:
+        m = re.match(r"^([a-zA-Z]+)(?:\([^)]+\))?!?:\s*(.+)", msg)
+        if m:
+            commit_type = m.group(1).lower()
+            subject = m.group(2)
+            heading = mapping.get(commit_type, "Other")
+            categories[heading].append(f"- {msg}")
+        else:
+            # Non-conventional or cannot parse: include verbatim under Other
+            categories["Other"].append(f"- {msg}")
+
+    # Remove empty categories
+    return {k: v for k, v in categories.items() if v}
+
+
+def format_changelog_entry(version, date, categories):
+    """Format a single changelog entry for the given version."""
+    lines = [f"\n## [{version}] - {date}\n"]
+    for heading in ["Added", "Fixed", "Performance", "Documentation", "Style",
+                    "Refactored", "Tests", "Chores", "CI/CD", "Build", "Reverts", "Other"]:
+        items = categories.get(heading)
+        if items:
+            lines.append(f"### {heading}\n" + "\n".join(items) + "\n")
+    return "".join(lines).strip() + "\n"
+
+
+def prepend_to_changelog(entry, changelog_path):
+    """Prepend entry to CHANGELOG.md, after any header."""
+    path = Path(changelog_path)
+    if not path.exists():
+        # Create minimal file with entry at top
+        header = "# Changelog\n\nAll notable changes to this project will be documented in this file.\n\n"
+        path.write_text(header + entry)
+        return
+
+    content = path.read_text(encoding="utf-8")
+    # Find the position of the first existing "## [" section
+    match = re.search(r"(?m)^## \[", content)
+    if match:
+        insert_pos = match.start()
+        new_content = content[:insert_pos] + entry + content[insert_pos:]
+    else:
+        # No existing entries, just append after header (or at end)
+        new_content = content.rstrip() + "\n\n" + entry
+
+    path.write_text(new_content, encoding="utf-8")
+
+
+def tag_exists(tag):
+    """Check if a git tag exists."""
+    try:
+        existing = run_git("tag", "-l", tag)
+        return tag in existing.splitlines()
+    except subprocess.CalledProcessError:
+        return False
+
+
+def main():
+    bump = os.getenv("BUMP")
+    if not bump:
+        print("Error: BUMP environment variable not set", file=sys.stderr)
+        sys.exit(1)
+
+    changelog_path = Path("CHANGELOG.md")
+
+    latest_tag = get_latest_stable_tag()
+    major, minor, patch = parse_version(latest_tag)
+    new_major, new_minor, new_patch, suffix = bump_version(major, minor, patch, bump)
+    new_version = f"{new_major}.{new_minor}.{new_patch}{suffix}"
+    tag_name = f"v{new_version}"
+
+    # Check if tag already exists
+    if tag_exists(tag_name):
+        print(f"Error: Tag '{tag_name}' already exists. Choose a different bump or delete the existing tag.", file=sys.stderr)
+        sys.exit(1)
+
+    commits = get_commits_since_tag(latest_tag)
+    categories = categorize_commits(commits)
+
+    date_str = datetime.now().strftime("%Y-%m-%d")
+    entry = format_changelog_entry(new_version, date_str, categories)
+
+    prepend_to_changelog(entry, changelog_path)
+
+    # Set GITHUB_OUTPUT
+    gh_output = os.getenv("GITHUB_OUTPUT")
+    if gh_output:
+        with open(gh_output, "a", encoding="utf-8") as f:
+            f.write(f"new_version={new_version}\n")
+            f.write(f"tag_name={tag_name}\n")
+    else:
+        # For local testing: print to stdout
+        print(f"::set-output name=new_version::{new_version}")
+        print(f"::set-output name=tag_name::{tag_name}")
+
+    print(f"Generated changelog for {tag_name}")
+
+
+if __name__ == "__main__":
+    main()

piagentsync-0.0.1rc0/.github/workflows/ci.yml

@@ -0,0 +1,20 @@
+name: CI
+
+on:
+  push:
+    branches: [ "**" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+        with:
+          python-version: "3.13"
+      - run: uv sync --frozen
+      - run: uv run ruff check src/ tests/
+      - run: uv run ruff format --check src/ tests/
+      - run: uv run pytest tests/ --cov=piagentsync --cov-report=term-missing

piagentsync-0.0.1rc0/.github/workflows/publish.yml

@@ -0,0 +1,20 @@
+name: Publish
+
+on:
+  workflow_dispatch:
+
+permissions:
+  id-token: write
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+        with:
+          python-version: "3.13"
+      - run: uv sync --frozen
+      - run: uv build
+      - run: uv publish

piagentsync-0.0.1rc0/.github/workflows/tag.yml

@@ -0,0 +1,66 @@
+name: Tag
+
+on:
+  workflow_dispatch:
+    inputs:
+      bump:
+        description: 'Version bump type'
+        required: true
+        type: choice
+        options:
+          - PATCH
+          - MINOR
+          - MAJOR
+          - RC
+
+permissions:
+  contents: write
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+        with:
+          python-version: "3.13"
+      - run: uv sync --frozen
+      - run: uv run ruff check src/ tests/
+      - run: uv run ruff format --check src/ tests/
+      - run: uv run pytest tests/ --cov=piagentsync --cov-report=term-missing
+
+  tag:
+    needs: [test]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+      - name: Generate changelog and compute version
+        id: changelog
+        env:
+          BUMP: ${{ inputs.bump }}
+        run: |
+          python .github/scripts/generate_changelog.py
+      - name: Bump version in pyproject.toml
+        run: |
+          sed -i "s/^version = .*/version = \"${{ steps.changelog.outputs.new_version }}\"/" pyproject.toml
+      - name: Bump version in src/piagentsync/__init__.py
+        run: |
+          sed -i "s/^__version__ = .*/__version__ = \"${{ steps.changelog.outputs.new_version }}\"/" src/piagentsync/__init__.py
+      - name: Configure git identity
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+      - name: Commit version bump
+        run: |
+          git add pyproject.toml src/piagentsync/__init__.py CHANGELOG.md
+          git commit -m "chore(release): bump version to ${{ steps.changelog.outputs.new_version }}"
+          git push origin main
+      - name: Create and push tag
+        run: |
+          git tag ${{ steps.changelog.outputs.tag_name }}
+          git push origin ${{ steps.changelog.outputs.tag_name }}
+      - name: Print confirmation
+        run: echo "Created tag ${{ steps.changelog.outputs.tag_name }} for version ${{ steps.changelog.outputs.new_version }}"

piagentsync-0.0.1rc0/.gitignore

@@ -0,0 +1,55 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+venv/
+env/
+.venv
+ENV/
+env.bak/
+venv.bak/
+
+# IDEs
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# UV
+.uv/
+
+# Local config
+.env
+.env.local
+
+# Project specific
+.vault/
+.opencode/
+
+# macOS
+.DS_Store

piagentsync-0.0.1rc0/.python-version

@@ -0,0 +1 @@
+3.13

piagentsync-0.0.1rc0/CHANGELOG.md

@@ -0,0 +1,43 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.0.1-rc] - 2026-03-27
+### Added
+- feat(ci): automate changelog generation and remove test gate from publish
+- feat(piagentsync): initial implementation with full test suite
+### Fixed
+- fix(ci): prevent duplicate tags by checking existing tags
+### Tests
+- test(cli): make version check dynamic using package __version__
+### Chores
+- chore(release): bump version to 0.0.1-rc
+- chore(release): bump version to 0.0.1-rc
+### CI/CD
+- ci: add GitHub Actions workflows for CI, tagging, and publishing
+### Other
+- Initial commit
+## [0.0.1-rc] - 2026-03-27
+### Added
+- feat(ci): automate changelog generation and remove test gate from publish
+- feat(piagentsync): initial implementation with full test suite
+### Tests
+- test(cli): make version check dynamic using package __version__
+### Chores
+- chore(release): bump version to 0.0.1-rc
+### CI/CD
+- ci: add GitHub Actions workflows for CI, tagging, and publishing
+### Other
+- Initial commit
+## [0.1.0] - 2026-03-27
+
+### Added
+- Initial release of piagentsync
+- Sync OpenCode agents and skills from Obsidian vault to workspace
+- CLI commands: `pull`, `status`, `init`
+- Support for global agents
+- Dry-run mode
+- Full TDD implementation with pytest

piagentsync-0.0.1rc0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Piwero
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

piagentsync-0.0.1rc0/PKG-INFO

@@ -0,0 +1,161 @@
+Metadata-Version: 2.4
+Name: piagentsync
+Version: 0.0.1rc0
+Summary: Sync OpenCode agents and skills from an Obsidian vault to workspace directories
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.13
+Requires-Dist: pydantic-settings>=2.3
+Requires-Dist: pydantic>=2.7
+Requires-Dist: python-frontmatter>=1.1
+Requires-Dist: rich>=13
+Requires-Dist: typer>=0.12
+Description-Content-Type: text/markdown
+
+# piagentsync
+
+Sync OpenCode agents and skills from an Obsidian vault to workspace directories.
+
+## Install
+
+```bash
+uv add piagentsync
+# or
+pip install piagentsync
+```
+
+## Quick start
+
+1. Initialize a new project in your vault:
+
+```bash
+piagentsync init myproject --workspace ~/workspace/myproject
+```
+
+2. Pull the synced files to your workspace:
+
+```bash
+piagentsync pull myproject
+```
+
+## Configuration
+
+Environment variables (also configurable via `.env` file):
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `PIAGENTSYNC_VAULT_PATH` | `~/vault` | Path to Obsidian vault |
+| `PIAGENTSYNC_GLOBAL_OPENCODE_PATH` | `~/.config/opencode` | Path to global OpenCode config |
+
+## CLI reference
+
+### `piagentsync pull <project>`
+
+Sync a single project from vault to workspace.
+
+Options:
+- `--dry-run` / `--no-dry-run` — preview changes without writing
+- `--global` / `--no-global` — also sync global agents
+- `--all` — sync all discovered projects
+
+### `piagentsync status [project]`
+
+Show diff between vault and workspace.
+
+Options:
+- `--all` — show status for all projects (default when no project given)
+
+### `piagentsync init <project>`
+
+Scaffold a new project in the vault.
+
+Options:
+- `--workspace PATH` — required, workspace directory
+- `--notion-board-id TEXT` — optional Notion DB ID
+- `--notion-project-filter TEXT` — optional Notion project filter (defaults to project slug)
+
+### `--version`
+
+Print version and exit.
+
+## AGENTS.md manifest format
+
+Each project must have an `AGENTS.md` file in its root with YAML frontmatter:
+
+```yaml
+---
+project: myproject
+workspace: ~/workspace/myproject
+notion_board_id: 3305f9479a8d8055b3c3e86a9006cf91
+notion_project_filter: myproject
+---
+```
+
+The body below the frontmatter is the OpenCode routing table.
+
+## Expected vault structure
+
+```
+vault/
+├── agents/
+│   └── global/
+│       └── *.md
+└── projects/
+    └── {project}/
+        ├── AGENTS.md           # manifest with frontmatter
+        ├── context.md          # optional context file
+        ├── decisions.md        # optional decisions log
+        ├── agents/
+        │   └── *.md
+        └── skills/
+            └── *.md
+```
+
+## Contributing
+
+Development setup:
+
+```bash
+uv sync
+uv run pytest
+```
+
+Lint and format:
+
+```bash
+uv run ruff check src/ tests/
+uv run ruff format src/ tests/
+```
+
+All commits follow [Conventional Commits](https://www.conventionalcommits.org/).
+
+### Publishing (maintainers)
+
+This repository uses GitHub Actions for CI and automated releases.
+
+#### One-time PyPI setup (trusted publisher)
+
+1. Enable OIDC on PyPI for the repository:
+   - Publisher: GitHub Actions
+   - Repository owner: `Piwero`
+   - Repository name: `piagentsync`
+   - Workflow filename: `publish.yml`
+   - Environment name: (leave blank)
+
+2. Push a tag to trigger the `tag.yml` workflow to bump version and create a git tag.
+
+3. After the tag workflow completes, the `publish.yml` workflow will automatically build and publish the package to PyPI.
+
+#### Release process
+
+```text
+git push → ci.yml passes
+   → trigger tag.yml (choose MAJOR/MINOR/PATCH/RC)
+       → tests re-run → version bumped → tag pushed
+   → trigger publish.yml
+       → tests re-run → built → published to PyPI
+```
+
+## License
+
+MIT