agentshift 0.1.0__tar.gz

agentshift-0.1.0/.github/CODEOWNERS

@@ -0,0 +1,25 @@
+# AgentShift Code Owners
+# These owners will be automatically requested for review on PRs.
+
+# Global — all PRs need maintainer review
+* @ogkranthi
+
+# Core IR schema — changes here affect everything
+src/agentshift/ir.py @ogkranthi
+specs/ir-schema.json @ogkranthi
+
+# Parsers
+src/agentshift/parsers/ @ogkranthi
+
+# Emitters
+src/agentshift/emitters/ @ogkranthi
+
+# CLI
+src/agentshift/cli.py @ogkranthi
+
+# CI/CD and project config
+.github/ @ogkranthi
+pyproject.toml @ogkranthi
+
+# Specs — format documentation
+specs/ @ogkranthi

agentshift-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,93 @@
+name: Bug Report
+description: Report a bug in AgentShift
+title: "[Bug]: "
+labels: ["bug", "triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting a bug! Please fill out the sections below.
+
+  - type: input
+    id: version
+    attributes:
+      label: AgentShift Version
+      description: Run `agentshift --version` to get this
+      placeholder: "0.1.0"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: command
+    attributes:
+      label: Which command?
+      options:
+        - convert
+        - diff
+        - validate
+        - other
+    validations:
+      required: true
+
+  - type: dropdown
+    id: platform
+    attributes:
+      label: Which platform(s) are involved?
+      multiple: true
+      options:
+        - OpenClaw
+        - Claude Code
+        - Microsoft Copilot
+        - AWS Bedrock
+        - GCP Vertex AI
+        - LangGraph
+        - CrewAI
+        - Other
+
+  - type: textarea
+    id: description
+    attributes:
+      label: What happened?
+      description: A clear description of the bug
+      placeholder: When I run `agentshift convert --to copilot ./my-skill/`, it fails with...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+      description: What did you expect to happen?
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Steps to reproduce
+      description: Minimal steps to reproduce the bug
+      value: |
+        1. Create a skill with...
+        2. Run `agentshift convert ...`
+        3. See error...
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Error output / logs
+      description: Paste the full error output
+      render: shell
+
+  - type: input
+    id: os
+    attributes:
+      label: OS
+      placeholder: "macOS 14.2 / Ubuntu 22.04 / Windows 11"
+
+  - type: input
+    id: python
+    attributes:
+      label: Python version
+      placeholder: "3.12.1"

agentshift-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Discussions
+    url: https://github.com/ogkranthi/agentshift/discussions
+    about: Ask questions and discuss ideas

agentshift-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,54 @@
+name: Feature Request
+description: Suggest a new feature or improvement
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting an improvement! Please describe your idea below.
+
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area
+      options:
+        - New platform support
+        - Parser improvement
+        - Emitter improvement
+        - CLI / UX
+        - Diff / validation
+        - IR schema
+        - Documentation
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear description of what you'd like
+      placeholder: I'd like AgentShift to support converting agents to/from...
+    validations:
+      required: true
+
+  - type: textarea
+    id: motivation
+    attributes:
+      label: Motivation
+      description: Why is this useful? What problem does it solve?
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Have you considered other approaches?
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional context
+      description: Any other context, screenshots, or examples

agentshift-0.1.0/.github/ISSUE_TEMPLATE/platform_request.yml

@@ -0,0 +1,55 @@
+name: New Platform Support
+description: Request support for a new agent platform
+title: "[Platform]: "
+labels: ["platform-request", "enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Want AgentShift to support a new agent platform? Tell us about it!
+
+  - type: input
+    id: platform
+    attributes:
+      label: Platform name
+      placeholder: "e.g., Salesforce Agentforce, ServiceNow AI Agents"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: direction
+    attributes:
+      label: Direction needed
+      options:
+        - Parser (read from this platform)
+        - Emitter (write to this platform)
+        - Both (bidirectional)
+    validations:
+      required: true
+
+  - type: textarea
+    id: format
+    attributes:
+      label: Agent definition format
+      description: How are agents defined on this platform? Links to docs appreciated.
+      placeholder: |
+        Agents are defined as JSON manifests with...
+        Docs: https://...
+    validations:
+      required: true
+
+  - type: textarea
+    id: example
+    attributes:
+      label: Example agent definition
+      description: Paste an example agent config from this platform
+      render: json
+
+  - type: dropdown
+    id: willingness
+    attributes:
+      label: Would you contribute this?
+      options:
+        - "Yes, I can implement it"
+        - "I can help test it"
+        - "Just requesting — no bandwidth to contribute"

agentshift-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,53 @@
+## Summary
+
+<!-- What does this PR do? Keep it to 1-3 sentences. -->
+
+## Type
+
+- [ ] New parser (source platform)
+- [ ] New emitter (target platform)
+- [ ] IR schema change
+- [ ] Bug fix
+- [ ] CLI improvement
+- [ ] Documentation
+- [ ] Tests
+- [ ] CI / tooling
+
+## Changes
+
+<!-- Bullet list of what changed -->
+
+-
+
+## Platforms affected
+
+<!-- Which platforms does this touch? -->
+
+- [ ] OpenClaw
+- [ ] Claude Code
+- [ ] Microsoft Copilot
+- [ ] AWS Bedrock
+- [ ] GCP Vertex AI
+- [ ] None (infrastructure / docs)
+
+## Testing
+
+<!-- How did you verify this works? -->
+
+- [ ] Unit tests pass (`pytest tests/`)
+- [ ] Added new tests for this change
+- [ ] Tested with a real agent/skill
+- [ ] Round-trip test passes (if parser/emitter change)
+- [ ] Generated configs validated against platform schema
+
+## Checklist
+
+- [ ] Code follows the [contributing guidelines](CONTRIBUTING.md)
+- [ ] Type hints on all new function signatures
+- [ ] No secrets, tokens, or credentials in the diff
+- [ ] Updated relevant specs in `specs/` (if IR or format change)
+- [ ] PR is scoped to a single concern (no unrelated changes)
+
+## Related issues
+
+<!-- Link related issues: Fixes #123, Relates to #456 -->

agentshift-0.1.0/.github/SETUP.md

@@ -0,0 +1,65 @@
+# GitHub Repository Setup (Manual Steps)
+
+These settings require admin access and can't be set via the current CLI token.
+
+## 1. Repository Settings
+
+Go to **Settings → General**:
+
+- [x] Description: "CLI transpiler for converting AI agents between platforms"
+- [x] Enable Discussions
+- [x] Enable Issues
+- [x] Disable Wiki (not needed — docs live in repo)
+- [x] Allow auto-merge
+- [x] Automatically delete head branches after merge
+
+## 2. Branch Protection Rules
+
+Go to **Settings → Branches → Add rule**:
+
+**Branch name pattern:** `main`
+
+- [x] Require a pull request before merging
+  - [x] Require approvals: **1**
+  - [x] Dismiss stale pull request approvals when new commits are pushed
+  - [x] Require review from Code Owners
+- [x] Require status checks to pass before merging
+  - [x] Require branches to be up to date before merging
+  - Required checks:
+    - `Lint`
+    - `Test (Python 3.12)`
+    - `Build package`
+- [x] Require conversation resolution before merging
+- [ ] Do NOT require signed commits (keeps barrier low for contributors)
+- [x] Do not allow force pushes
+- [x] Do not allow deletions
+
+## 3. Labels
+
+Create these labels in **Issues → Labels**:
+
+| Label | Color | Description |
+|-------|-------|-------------|
+| `bug` | `#d73a4a` | Something isn't working |
+| `enhancement` | `#a2eeef` | New feature or request |
+| `platform-request` | `#0075ca` | Request for a new platform |
+| `good first issue` | `#7057ff` | Good for newcomers |
+| `help wanted` | `#008672` | Extra attention is needed |
+| `triage` | `#e4e669` | Needs triage |
+| `parser` | `#1d76db` | Related to a parser |
+| `emitter` | `#1d76db` | Related to an emitter |
+| `ir-schema` | `#d876e3` | Related to the IR schema |
+| `cli` | `#bfd4f2` | Related to the CLI |
+| `docs` | `#0075ca` | Documentation |
+| `wontfix` | `#ffffff` | This will not be worked on |
+
+## 4. Enable GitHub Discussions
+
+Go to **Settings → General → Features**:
+- [x] Discussions
+
+Create these discussion categories:
+- **Announcements** (maintainers only)
+- **Ideas** (open)
+- **Q&A** (open, answer-markable)
+- **Show and Tell** (open)

agentshift-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,85 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install ruff
+        run: pip install ruff
+      - name: Check formatting
+        run: ruff format --check src/ tests/
+      - name: Check linting
+        run: ruff check src/ tests/
+
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+      - name: Run tests
+        run: pytest tests/ -v --tb=short --cov=agentshift --cov-report=term-missing
+      - name: Check coverage
+        run: pytest tests/ --cov=agentshift --cov-fail-under=60
+
+  build:
+    name: Build package
+    runs-on: ubuntu-latest
+    needs: [lint, test]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install build tools
+        run: pip install build
+      - name: Build package
+        run: python -m build
+      - name: Verify CLI entry point
+        run: |
+          pip install dist/*.whl
+          agentshift --help
+
+  schema-validate:
+    name: Validate IR Schema
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install dependencies
+        run: pip install jsonschema pyyaml
+      - name: Validate IR schema
+        run: |
+          python -c "
+          import json, sys
+          from pathlib import Path
+          schema_path = Path('specs/ir-schema.json')
+          if schema_path.exists():
+              schema = json.loads(schema_path.read_text())
+              print(f'IR schema valid: {len(schema)} top-level keys')
+          else:
+              print('IR schema not yet created — skipping')
+          "

agentshift-0.1.0/.gitignore

@@ -0,0 +1,39 @@
+# Python
+.venv/
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+*.egg
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# OpenClaw workspace state (local only)
+.openclaw/
+HEARTBEAT.md
+IDENTITY.md
+SOUL.md
+TOOLS.md
+USER.md
+
+# Environment
+.env
+.env.local
+
+# Generated output
+agentshift-output/

agentshift-0.1.0/AGENTS.md

@@ -0,0 +1,68 @@
+# AgentShift — Autonomous Build Crew
+
+## Architecture
+
+AgentShift is built by a team of 4 autonomous agents coordinated through a shared BACKLOG.md.
+
+```
+🚢 Chief (coordinator)
+├── 📐 Architect (specs, schemas, research)
+├── 💻 Dev (Python implementation)
+└── 🧪 Tester (tests, validation, QA)
+```
+
+## Agent Roles
+
+### 🚢 Chief (`agentshift-chief`)
+- **Owns**: Coordination, backlog management, status updates
+- **Tools**: sessions_spawn, sessions_send, message, cron
+- **Telegram**: Receives commands, sends status updates
+- **Does NOT**: Write code, specs, or tests
+
+### 📐 Architect (`agentshift-architect`)
+- **Owns**: IR schema, platform format specs, mapping docs
+- **Writes to**: `specs/`, `docs/adr/`
+- **Tools**: web_search, web_fetch, read, write, edit, exec
+- **Sequence**: Produces specs BEFORE dev implements
+
+### 💻 Dev (`agentshift-dev`)
+- **Owns**: Python codebase — parsers, emitters, CLI, IR model
+- **Writes to**: `src/agentshift/`, `pyproject.toml`
+- **Tools**: read, write, edit, exec
+- **Sequence**: Implements AFTER architect produces spec
+
+### 🧪 Tester (`agentshift-tester`)
+- **Owns**: Test suite, fixtures, config validation
+- **Writes to**: `tests/`
+- **Tools**: read, write, edit, exec
+- **Sequence**: Tests AFTER dev implements; also reviews dev PRs
+
+## Build Flow
+
+1. Chief reads BACKLOG.md, identifies ready tasks
+2. Architect researches and writes specs (A-prefixed tasks)
+3. Dev implements based on specs (D-prefixed tasks)
+4. Tester writes tests and validates (T-prefixed tasks)
+5. Tester reviews and merges dev PRs
+6. Chief reports progress to Telegram
+
+## Branch Convention
+- `agent/architect/{task-id}` — spec branches
+- `agent/dev/{task-id}` — implementation branches
+- `agent/tester/{task-id}` — test branches
+
+## Project Structure
+```
+agentshift/
+├── src/agentshift/       # Python package
+│   ├── cli.py            # Typer CLI
+│   ├── ir.py             # IR model
+│   ├── parsers/          # Source format parsers
+│   └── emitters/         # Target format emitters
+├── specs/                # Format specs (by architect)
+├── tests/                # Test suite (by tester)
+├── docs/                 # Documentation
+├── examples/             # Example conversions
+├── BACKLOG.md            # Task queue
+└── AGENTS.md             # This file
+```

agentshift-0.1.0/BACKLOG.md

@@ -0,0 +1,55 @@
+# AgentShift Backlog
+
+## Format
+| ID | Priority | Owner | Status | Title |
+|----|----------|-------|--------|-------|
+
+**Statuses:** `ready` → `in-progress` → `pr-created` → `merged` | `blocked`
+**Owners:** `@architect`, `@dev`, `@tester`, `@chief`
+
+---
+
+## Week 1: Foundation + IR + OpenClaw ↔ Claude Code
+
+| ID | Priority | Owner | Status | Title |
+|----|----------|-------|--------|-------|
+| A01 | P0 | @architect | merged | Design IR JSON Schema — universal agent model |
+| A02 | P0 | @architect | merged | Document OpenClaw SKILL.md format spec with examples |
+| A03 | P0 | @architect | merged | Document Claude Code format spec (SKILL.md + CLAUDE.md + settings.json) |
+| A04 | P1 | @architect | ready | Document Copilot declarative agent manifest schema 1.6 |
+| A05 | P1 | @architect | ready | Document Bedrock agent config + OpenAPI action group format |
+| A06 | P1 | @architect | ready | Document Vertex AI Agent Builder config format |
+| A07 | P1 | @architect | ready | Write MCP-to-OpenAPI mapping specification |
+| D01 | P0 | @dev | ready | Set up Python project scaffold (pyproject.toml, src layout, CLI entry point) |
+| D02 | P0 | @dev | ready | Implement IR model as Python dataclasses (based on A01 spec) |
+| D03 | P0 | @dev | ready | Implement OpenClaw parser (SKILL.md → IR) |
+| D04 | P0 | @dev | ready | Implement Claude Code emitter (IR → SKILL.md + CLAUDE.md) |
+| D05 | P0 | @dev | ready | Implement Claude Code parser (SKILL.md + CLAUDE.md → IR) |
+| D06 | P0 | @dev | ready | Implement `agentshift convert` CLI command |
+| T01 | P0 | @tester | ready | Create test fixture skills (simple, tool-heavy, cron-knowledge) |
+| T02 | P0 | @tester | ready | Write parser tests for OpenClaw parser |
+| T03 | P0 | @tester | ready | Write round-trip tests (OpenClaw → IR → OpenClaw) |
+| T04 | P0 | @tester | ready | Copy pregnancy-companion as integration test fixture |
+
+## Week 2: Cloud Emitters
+
+| ID | Priority | Owner | Status | Title |
+|----|----------|-------|--------|-------|
+| D07 | P1 | @dev | ready | Implement Copilot emitter (IR → manifest.json + plugin.json) |
+| D08 | P1 | @dev | ready | Implement Bedrock emitter (IR → instruction + OpenAPI + CloudFormation) |
+| D09 | P1 | @dev | ready | Implement Vertex AI emitter (IR → Agent Builder config) |
+| D10 | P1 | @dev | ready | Handle platform constraints (instruction length limits, etc.) |
+| T05 | P1 | @tester | ready | Write emitter tests for all cloud targets |
+| T06 | P1 | @tester | ready | Validate generated Copilot manifest against JSON schema |
+
+## Week 3: Diff + Validate
+
+| ID | Priority | Owner | Status | Title |
+|----|----------|-------|--------|-------|
+| D11 | P1 | @dev | ready | Implement MCP-to-OpenAPI converter |
+| D12 | P1 | @dev | ready | Implement `agentshift diff` command with rich table output |
+| D13 | P1 | @dev | ready | Implement `agentshift validate` command |
+| D14 | P1 | @dev | ready | Generate auth/trigger/data binding stubs with TODO comments |
+| T07 | P1 | @tester | ready | Write diff accuracy tests |
+| T08 | P1 | @tester | ready | Write CLI integration tests (end-to-end) |
+| T09 | P1 | @tester | ready | Full integration test: pregnancy-companion → all 4 targets |

agentshift-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,43 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior:
+
+* The use of sexualized language or imagery, and sexual attention or advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when an individual is officially representing the community in public spaces.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the project maintainers at **conduct@agentshift.dev** (or via GitHub issues marked `[conduct]`).
+
+All complaints will be reviewed and investigated promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/), version 2.1.