gitmap-core 0.1.0__tar.gz

gitmap_core-0.1.0/.claude/settings.local.json

@@ -0,0 +1,16 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(xargs ls:*)",
+      "Bash(tree:*)",
+      "Bash(python:*)",
+      "Bash(python3:*)",
+      "Bash(grep -r \"export\\\\|json\\\\|csv\" /Users/tr/Desktop/Git-Map/apps/cli/gitmap/commands/*.py)",
+      "Bash(xargs:*)",
+      "Bash(uv run pytest:*)",
+      "Bash(docker compose run:*)",
+      "Bash(docker compose:*)",
+      "Bash(docker compose logs:*)"
+    ]
+  }
+}

gitmap_core-0.1.0/.devcontainer/devcontainer.json

@@ -0,0 +1,22 @@
+{
+  "name": "GitMap ArcGIS",
+  "dockerComposeFile": ["../docker-compose.yml", "docker-compose.override.yml"],
+  "service": "dev",
+  "workspaceFolder": "/app",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "ms-python.python",
+        "ms-python.vscode-pylance",
+        "ms-python.black-formatter"
+      ],
+      "settings": {
+        "python.defaultInterpreterPath": "/usr/local/bin/python",
+        "python.formatting.provider": "black"
+      }
+    }
+  },
+  "postCreateCommand": "pip install -r requirements.txt"
+}
+
+

gitmap_core-0.1.0/.devcontainer/docker-compose.override.yml

@@ -0,0 +1,2 @@
+services:
+  dev: {}

gitmap_core-0.1.0/.github/FUNDING.yml

@@ -0,0 +1,15 @@
+# These are supported funding model platforms
+
+github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+polar: # Replace with a single Polar username
+buy_me_a_coffee: tr.14
+thanks_dev: # Replace with a single thanks.dev username
+custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

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

@@ -0,0 +1,36 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e "packages/gitmap_core[dev]"
+
+      - name: Run tests
+        run: |
+          python -m pytest packages/gitmap_core/tests -v --tb=short
+
+      - name: Run tests with coverage
+        if: matrix.python-version == '3.11'
+        run: |
+          python -m pytest packages/gitmap_core/tests --cov=packages/gitmap_core --cov-report=term-missing --cov-fail-under=90

gitmap_core-0.1.0/.gitignore

@@ -0,0 +1,65 @@
+# macOS
+.DS_Store
+.DS_Store?
+._*
+
+# Python
+*.pyc
+__pycache__/
+*.egg
+*.egg-info/
+dist/
+build/
+*.whl
+*.tar.gz
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+.cursor/
+
+# Environment
+.env
+.env.*
+!.env.example
+configs/.env
+*.env
+.venv/
+venv/
+
+# Secrets and credentials
+*.key
+*.pem
+*.p12
+*.pfx
+*.secret
+*_secret
+*_password
+*_token
+*_credential
+secrets/
+credentials/
+
+# Logs
+*.log
+logs/
+
+# Database
+*.db
+*.sqlite
+*.sqlite3
+
+# Temporary files
+*.tmp
+*.temp
+.cache/
+
+#data directories
+data/ 
+
+# repositories
+repositories/  
+docker-compose.yml
+.coverage

gitmap_core-0.1.0/CHANGELOG.md

@@ -0,0 +1,87 @@
+# Changelog
+
+All notable changes to GitMap will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.5.0] - 2025-02-14
+
+### Added
+- Communication module for Portal user/group notifications
+- Push notifications to group members on production branch updates
+- `notify` command for sending messages to Portal groups
+
+### Changed
+- Improved `__init__.py` efficiency with lazy imports
+- Enhanced test coverage across all core modules (608+ tests)
+
+### Fixed
+- Pytest config path for test collection on fresh clones
+- Type errors in repository and diff modules (mypy compliance)
+
+## [0.4.0] - 2025-02-10
+
+### Added
+- `stash` command to save work-in-progress without committing
+- `cherry-pick` command to apply specific commits to current branch
+- `tag` command for marking specific commits with version labels
+- `revert` command to undo specific commits with inverse changes
+- ArcGIS API version compatibility layer for broader Portal support
+
+### Fixed
+- Folder creation handling for different Portal versions
+- Feature branch pushing to root content (skip folder creation)
+- Empty folder creation result handling
+
+## [0.3.0] - 2025-01-20
+
+### Added
+- Context visualization in multiple formats (Mermaid flowchart, timeline, git-graph, ASCII, HTML)
+- GitHub Actions workflow for automated testing
+- Auto-regenerate context graph on branch, merge, pull, push, and init operations
+
+### Changed
+- Improved flowchart branch/merge linking visualization
+- Enhanced git-graph with merge, LSM, and branch event display
+
+## [0.2.0] - 2025-01-10
+
+### Added
+- Auto-pull daemon with interval-based scheduling
+- Auto-commit functionality with customizable commit messages
+- GitMap TUI client with Textual framework
+- GitMap GUI with modular architecture
+- Services browser with one-click item ID copy
+- LSM (Layer Settings Merge) health check and redesigned page
+
+### Changed
+- Reorganized GUI navigation structure
+
+## [0.1.0] - 2024-12-30
+
+### Added
+- Initial release with core version control features
+- `init` - Initialize a new GitMap repository
+- `clone` - Clone a web map from Portal/AGOL
+- `commit` - Save changes with a message
+- `branch` - Create and manage branches
+- `checkout` - Switch between branches
+- `diff` - Compare map versions
+- `merge` - Merge branches with conflict resolution
+- `push` - Upload changes to Portal/AGOL
+- `pull` - Download changes from Portal/AGOL
+- `log` - View commit history
+- `status` - Show repository status
+- `config` - Manage repository configuration
+- `list` - Discover web maps from Portal
+- `setup-repos` - Bulk repository setup with owner filtering
+- `lsm` - Layer Settings Merge for transferring popup/form settings
+
+---
+
+[0.5.0]: https://github.com/14-TR/Git-Map/compare/v0.4.0...v0.5.0
+[0.4.0]: https://github.com/14-TR/Git-Map/compare/v0.3.0...v0.4.0
+[0.3.0]: https://github.com/14-TR/Git-Map/compare/v0.2.0...v0.3.0
+[0.2.0]: https://github.com/14-TR/Git-Map/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/14-TR/Git-Map/releases/tag/v0.1.0

gitmap_core-0.1.0/CLAUDE.md

@@ -0,0 +1,327 @@
+# CLAUDE.md - GitMap Project Guide
+
+This document is the primary reference for AI assistants (Claude Code, Cursor, etc.) working on the GitMap project.
+
+## Project Overview
+
+**GitMap** provides Git-like version control for ArcGIS Online and Enterprise Portal web maps. Branch, commit, diff, merge, push, and pull maps using familiar workflows.
+
+### Monorepo Structure
+
+```
+GitMap/
+├── apps/                    # Runnable applications
+│   ├── cli/gitmap/          # CLI application
+│   ├── client/              # Client applications
+│   │   ├── gitmap-client/   # TUI client (Textual)
+│   │   └── gitmap-gui/      # Web GUI (Flask)
+│   └── mcp/gitmap-mcp/      # MCP server
+├── packages/                # First-party libraries
+│   └── gitmap_core/         # Core library
+├── configs/                 # Configuration templates
+├── docker/                  # Docker configuration
+└── documentation/           # Specifications and docs
+    └── project_specs/       # Detailed specifications
+```
+
+### Key Applications
+
+- **gitmap CLI**: Git-like commands for web map version control
+- **gitmap-gui**: Flask-based web interface for visual management
+- **gitmap-client**: Terminal UI client using Textual framework
+- **gitmap-mcp**: MCP server for IDE integration
+
+---
+
+## Quick Start Commands
+
+```bash
+# Install core library (required for running tests)
+pip install -e packages/gitmap_core
+
+# Run tests (no editable install required - pythonpath configured in pyproject.toml)
+pytest
+
+# Install CLI
+pip install -e apps/cli/gitmap
+
+# Run GUI
+cd apps/client/gitmap-gui && python -m gitmap_gui
+
+# Run TUI client
+cd apps/client/gitmap-client && python -m gitmap_client
+```
+
+---
+
+## Protocol System
+
+Before responding to requests, consult `documentation/nav_spec.md` to identify the correct specification. Available protocols:
+
+| Protocol | Command Phrases | Governing Spec |
+|----------|-----------------|----------------|
+| `protocols.list` | "list protocols", "what can you do" | protocols_spec.md |
+| `apps.generate_template` | "generate app template", "create app" | apps_folder_spec.md |
+| `apps.add_feature` | "add feature to app", "implement feature" | apps_add_feature_spec.md |
+| `audit.perform` | "audit code", "perform audit" | audit_spec.md |
+| `spec.generate` | "generate spec", "create spec" | spec_template.md |
+| `release.guide` | "release guide", "create release" | cut_release_spec.md |
+
+### Checklist Gate (Mandatory)
+
+When a governing spec defines a Prompt Checklist:
+1. Collect checklist answers one-by-one
+2. Echo back a summary for confirmation
+3. **Block ALL edits** until engineer confirms
+4. Store captured answers in session task list
+
+---
+
+## Python Standards
+
+### Version & Style
+
+- **Python**: 3.11+
+- **Formatting**: PEP 8
+- **Docstrings**: PEP 257 (Google-style)
+- **Path Handling**: Always use `pathlib.Path`
+- **Type Hints**: Required for all functions
+
+### Required Import
+
+```python
+from __future__ import annotations
+```
+
+### Import Order
+
+1. Standard library imports
+2. Third-party library imports
+3. Local module imports
+
+### Function Formatting
+
+```python
+# ---- Helper Functions -----------------------------------------------------------------------
+
+def example_function(
+        param_1: str,
+        param_2: int,
+        param_3: Optional[str] = None,
+) -> bool:
+    """
+    One-line purpose sentence.
+
+    Args:
+        param_1: Description of param_1.
+        param_2: Description of param_2.
+        param_3: Description of param_3.
+
+    Returns:
+        bool: Description of return value.
+
+    Raises:
+        ValueError: When validation fails.
+    """
+    return True
+```
+
+### Exception Handling
+
+```python
+try:
+    result = some_operation()
+except SpecificError as specific_error:
+    msg = f"Failed to perform operation: {specific_error}"
+    raise RuntimeError(msg) from specific_error
+except Exception as general_error:
+    msg = f"Unexpected error during operation: {general_error}"
+    raise RuntimeError(msg) from general_error
+```
+
+**Rules**:
+- Error alias: `snake_case` of exception + `_error`
+- Message variable: `msg`
+- Always use f-strings (no `.format()` or `%` formatting)
+- Always chain exceptions with `from`
+
+---
+
+## App Structure
+
+### Directory Layout (Required)
+
+```
+apps/[app_group]/[app]/
+├── docs/
+│   └── [app_name]_spec.md
+├── configs/
+│   └── [app_name]_config.json
+├── scripts/           # Core implementation
+├── main.py            # Orchestrator entrypoint
+└── runner.py          # Optional; overrides orchestrator
+```
+
+### Module Docstring Template
+
+```python
+"""
+One-line summary.
+
+Extended description paragraph(s).
+
+Key Features:
+    - Feature 1
+    - Feature 2
+
+Dependencies:
+    - dependency 1
+    - dependency 2
+
+Metadata:
+    Author: Name
+    Version: 1.0
+"""
+```
+
+---
+
+## Code Quality Checks
+
+### Must-Have
+
+- [ ] PEP 8 compliance
+- [ ] Type hints on all functions
+- [ ] Docstrings on all public functions/classes/modules
+- [ ] No hardcoded credentials
+- [ ] pathlib.Path for file operations
+- [ ] Proper exception handling with chaining
+- [ ] Main guard: `if __name__ == '__main__'`
+
+### Avoid
+
+- [ ] Bare `except:` clauses
+- [ ] String concatenation for error messages
+- [ ] Relative imports in apps
+- [ ] Deep imports from packages (use public API)
+- [ ] Unnecessary external dependencies
+
+---
+
+## Branching Model
+
+### Branch Types
+
+| Prefix | Purpose |
+|--------|---------|
+| `feature/` | New functionality |
+| `bugfix/` | Non-urgent fixes |
+| `hotfix/` | Urgent production fixes |
+| `release/` | Release preparation |
+| `chore/` | Maintenance, dependencies |
+| `refactor/` | Code restructuring |
+| `docs/` | Documentation updates |
+
+### Naming Convention
+
+- Child: `[developer]/[type]/[description]`
+- Example: `jdoe/feature/add-layer-merge`
+
+---
+
+## Task Management
+
+Maintain lightweight progress visibility:
+- Provide 1-3 sentence status updates before major actions
+- Maintain a concise task list for active goals
+- Update task statuses as work progresses
+- Confirm completion and summarize changes
+
+---
+
+## Tool Output Formatting
+
+When a tool returns formatted output (e.g., `table`, `formatted_output`):
+- Use the tool's format directly
+- Do not reformat or restructure the output
+- Preserve the tool's intent
+
+---
+
+## Key Specifications Reference
+
+| Topic | Specification File |
+|-------|-------------------|
+| Agent Behavior | `00-governance/ide_agent.md` |
+| Documentation | `00-governance/docs_spec.md` |
+| Formatting | `00-governance/formatting_spec.md` |
+| Protocols | `00-governance/protocols_spec.md` |
+| Code Audit | `00-governance/audit_spec.md` |
+| Architecture | `10-architecture/architecture_spec.md` |
+| Python Standards | `10-architecture/repo_spec.md` |
+| App Structure | `30-apps/apps_folder_spec.md` |
+| Add Features | `30-apps/apps_add_feature_spec.md` |
+| ArcGIS API | `30-apps/arcgis_api_mapping.md` |
+
+All specifications are in `documentation/project_specs/`.
+
+---
+
+## ArcGIS Integration
+
+GitMap works with ArcGIS Portal and ArcGIS Online. Authentication:
+
+```bash
+# Environment variables
+PORTAL_URL=https://your-org.maps.arcgis.com
+PORTAL_USER=your_username
+PORTAL_PASSWORD=your_password
+```
+
+Key CLI commands:
+- `gitmap clone <item_id>` - Clone web map from Portal
+- `gitmap push` - Push changes to Portal
+- `gitmap pull` - Pull changes from Portal
+- `gitmap lsm` - Layer settings merge (popup/form transfer)
+- `gitmap list` - List available web maps
+- `gitmap context` - Visualize event history
+
+---
+
+## Error Response Protocol
+
+1. Handle errors gracefully without losing context
+2. Explain issues clearly with actionable solutions
+3. Guide users through resolution steps
+4. Never expose sensitive information in error messages
+
+---
+
+## Performance Guidelines
+
+- Profile before optimizing
+- Focus on algorithmic complexity first
+- Use generators for large datasets
+- Minimize I/O operations
+- Use context managers for resource cleanup
+- Cache expensive computations
+
+---
+
+## Git Commit Standards
+
+When creating commits:
+1. Run `git status` and `git diff` first
+2. Summarize the nature of changes
+3. Draft concise 1-2 sentence message focusing on "why"
+4. Never commit secrets or credentials
+5. End commit message with session link when applicable
+
+---
+
+## Links
+
+- [Main README](README.md)
+- [Release Notes](documentation/project_specs/20-operations/release_notes.md)
+- [CLI Docs](apps/cli/gitmap/docs/gitmap_spec.md)
+- [MCP Docs](apps/mcp/gitmap-mcp/docs/gitmap_mcp_spec.md)

gitmap_core-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 GitMap Contributors
+
+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.