syncestra 1.0.0__tar.gz

syncestra-1.0.0/.claude/learnings/index.yaml

@@ -0,0 +1,6 @@
+{
+  "version": 1,
+  "tags": {},
+  "project": "syncestra",
+  "last_updated": "2026-06-12"
+}

syncestra-1.0.0/.claude/learnings/pending.yaml

@@ -0,0 +1,272 @@
+{
+  "learnings": [
+    {
+      "rule": "/bmad-brainstorming I want to create a back up system that backsup mounted volumes to github. I want that for each service. so if I have openclaw , hermes, etc. each would use the tool to create a private repo on github and by default backup eveything but also make only some things that I select. I also want functions that would check that nothing changed, functions that would restore the backup or update the current state, etc.",
+      "why": "",
+      "type": "preference",
+      "tags": [
+        "patterns"
+      ],
+      "scope": "project",
+      "scope_detail": "project-wide",
+      "confidence": 0.7,
+      "created": "2026-06-12",
+      "last_used": "2026-06-12",
+      "reinforced": 0,
+      "raw_context": "/bmad-brainstorming I want to create a back up system that backsup mounted volumes to github. I want that for each service. so if I have openclaw , hermes, etc. each would use the tool to create a private repo on github and by default backup eveything but also make only some things that I select. I also want functions that would check that nothing changed, functions that would restore the backup or update the current state, etc."
+    },
+    {
+      "rule": "Should as easy to use by ai agents",
+      "why": "",
+      "type": "preference",
+      "tags": [
+        "patterns"
+      ],
+      "scope": "project",
+      "scope_detail": "project-wide",
+      "confidence": 0.7,
+      "created": "2026-06-13",
+      "last_used": "2026-06-13",
+      "reinforced": 0,
+      "raw_context": "primiary user isn't ai, it's still humans but it should be as easy to use by ai agents"
+    },
+    {
+      "rule": "Ensure all required imports are present",
+      "why": "Bug detected via \\bpatch\\b [Refined: bug recurred despite learning — Bug detected via \\bpatch\\b]",
+      "type": "bugfix",
+      "tags": [
+        "testing"
+      ],
+      "scope": "project",
+      "confidence": 1.0,
+      "created": "2026-06-13",
+      "last_used": "2026-06-16",
+      "reinforced": 9,
+      "raw_context": "auto-captured from bug fix",
+      "source": "bug-capture",
+      "files": [
+        "/Users/assaad/Documents/Coding projects/syncestra/tests/integration/test_profile_isolation.py"
+      ],
+      "_fingerprint": "5055e3a946ebfbaef316d0e8c1ecedd9"
+    },
+    {
+      "rule": "for the bmad-sprint-autopilot-teams-parallel-op_reviewed-tdd-plan-val and bmad-sprint-autopilot-teams-parallel-op_reviewed-tdd-plan-val-ques both, when impementing epics, it's still doing it in one chat instead of sending it to other agent per epics for better context management. fix that",
+      "why": "",
+      "type": "bugfix",
+      "tags": [
+        "patterns"
+      ],
+      "scope": "project",
+      "scope_detail": "project-wide",
+      "confidence": 0.75,
+      "created": "2026-06-13",
+      "last_used": "2026-06-13",
+      "reinforced": 0,
+      "raw_context": "for the bmad-sprint-autopilot-teams-parallel-op_reviewed-tdd-plan-val and bmad-sprint-autopilot-teams-parallel-op_reviewed-tdd-plan-val-ques both, when impementing epics, it's still doing it in one chat instead of sending it to other agent per epics for better context management. fix that"
+    },
+    {
+      "rule": "Review similar code paths for the same bug pattern",
+      "why": "Bug detected via \\bpatch\\b [Refined: bug recurred despite learning — Bug detected via \\b(?:fix|fixed|fixing)\\b]",
+      "type": "bugfix",
+      "tags": [
+        "testing"
+      ],
+      "scope": "project",
+      "confidence": 1.0,
+      "created": "2026-06-13",
+      "last_used": "2026-06-16",
+      "reinforced": 24,
+      "raw_context": "auto-captured from bug fix",
+      "source": "bug-capture",
+      "files": [
+        "/Users/assaad/Documents/Coding projects/syncestra/tests/integration/test_exit_code_plumbing.py"
+      ],
+      "_fingerprint": "b6a31dcc76595e2cb9108ee3b5276058"
+    },
+    {
+      "rule": "<ide_selection>The user selected the lines 1 to 17 from /git-error-1781406843648: > git pull --tags origin main From https://github.com/assaads/syncestra * branch main -> FETCH_HEAD hint: You have divergent branches and need to specify how to reconcile them. hint: You can do so by running one of the following commands sometime before hint: your next pull: hint: hint: git config pull.rebase false # merge hint: git config pull.rebase true # rebase hint: git config pull.ff only # fast-forward only hint: hint: You can replace \"git config\" with \"git config --global\" to set a default hint: preference for all repositories. You can also pass --rebase, --no-rebase, hint: or --ff-only on the command line to override the configured default per hint: invocation. fatal: Need to specify how to reconcile divergent branches. This may or may not be related to the current task.</ide_selection> solve this > git pull --tags origin main From https://github.com/assaads/syncestra * branch main -> FETCH_HEAD hint: You have divergent branches and need to specify how to reconcile them. hint: You can do so by running one of the following commands sometime before hint: your next pull: hint: hint: git config pull.rebase false # merge hint: git config pull.rebase true # rebase hint: git config pull.ff only # fast-forward only hint: hint: You can replace \"git config\" with \"git config --global\" to set a default hint: preference for all repositories. You can also pass --rebase, --no-rebase, hint: or --ff-only on the command line to override the configured default per hint: invocation. fatal: Need to specify how to reconcile divergent branches.",
+      "why": "",
+      "type": "reinforcement",
+      "tags": [
+        "config",
+        "infra"
+      ],
+      "scope": "project",
+      "scope_detail": "config",
+      "confidence": 0.75,
+      "created": "2026-06-14",
+      "last_used": "2026-06-14",
+      "reinforced": 0,
+      "raw_context": "<ide_selection>The user selected the lines 1 to 17 from /git-error-1781406843648: > git pull --tags origin main From https://github.com/assaads/syncestra * branch main -> FETCH_HEAD hint: You have divergent branches and need to specify how to reconcile them. hint: You can do so by running one of the following commands sometime before hint: your next pull: hint: hint: git config pull.rebase false # merge hint: git config pull.rebase true # rebase hint: git config pull.ff only # fast-forward only hint: hint: You can replace \"git config\" with \"git config --global\" to set a default hint: preference for all repositories. You can also pass --rebase, --no-rebase, hint: or --ff-only on the command line to override the configured default per hint: invocation. fatal: Need to specify how to reconcile divergent branches. This may or may not be related to the current task.</ide_selection> solve this > git pull --tags origin main From https://github.com/assaads/syncestra * branch main -> FETCH_HEAD hint: You have divergent branches and need to specify how to reconcile them. hint: You can do so by running one of the following commands sometime before hint: your next pull: hint: hint: git config pull.rebase false # merge hint: git config pull.rebase true # rebase hint: git config pull.ff only # fast-forward only hint: hint: You can replace \"git config\" with \"git config --global\" to set a default hint: preference for all repositories. You can also pass --rebase, --no-rebase, hint: or --ff-only on the command line to override the configured default per hint: invocation. fatal: Need to specify how to reconcile divergent branches."
+    },
+    {
+      "rule": "I want that and from all the previous suggested fixed I only want this: Make Tier 2 implementer-subagent the DEFAULT",
+      "why": "",
+      "type": "bugfix",
+      "tags": [
+        "patterns"
+      ],
+      "scope": "project",
+      "scope_detail": "project-wide",
+      "confidence": 0.7,
+      "created": "2026-06-15",
+      "last_used": "2026-06-15",
+      "reinforced": 0,
+      "raw_context": "I want that and from all the previous suggested fixed I only want this: Make Tier 2 implementer-subagent the DEFAULT"
+    },
+    {
+      "rule": "<ide_opened_file>The user opened the file /Users/assaad/Documents/Coding projects/syncestra/docs/plans/2026-06-15-auto-push-watchman.md in the IDE. This may or may not be related to the current task.</ide_opened_file> merge to main",
+      "why": "",
+      "type": "reinforcement",
+      "tags": [
+        "patterns"
+      ],
+      "scope": "project",
+      "scope_detail": "projects/syncestra/docs/plans (2026-06-15-auto-push-watchman.md)",
+      "confidence": 0.75,
+      "created": "2026-06-15",
+      "last_used": "2026-06-15",
+      "reinforced": 0,
+      "raw_context": "<ide_opened_file>The user opened the file /Users/assaad/Documents/Coding projects/syncestra/docs/plans/2026-06-15-auto-push-watchman.md in the IDE. This may or may not be related to the current task.</ide_opened_file> merge to main",
+      "files": [
+        "projects/syncestra/docs/plans/2026-06-15-auto-push-watchman.md"
+      ]
+    },
+    {
+      "rule": "Don't a new branch for that",
+      "why": "",
+      "type": "preference",
+      "tags": [
+        "auth"
+      ],
+      "scope": "project",
+      "scope_detail": "project-wide",
+      "confidence": 0.8,
+      "created": "2026-06-16",
+      "last_used": "2026-06-16",
+      "reinforced": 0,
+      "raw_context": "change the SYNCESTRA_TOKEN variable name in the whole repo to SYNCESTRA_GITHUB_TOKEN. don't use a new branch for that"
+    },
+    {
+      "rule": "merge to main",
+      "why": "",
+      "type": "reinforcement",
+      "tags": [
+        "patterns"
+      ],
+      "scope": "project",
+      "scope_detail": "project-wide",
+      "confidence": 0.75,
+      "created": "2026-06-16",
+      "last_used": "2026-06-16",
+      "reinforced": 0,
+      "raw_context": "merge to main"
+    },
+    {
+      "rule": "merge to main",
+      "why": "",
+      "type": "reinforcement",
+      "tags": [
+        "patterns"
+      ],
+      "scope": "project",
+      "scope_detail": "project-wide",
+      "confidence": 0.75,
+      "created": "2026-06-16",
+      "last_used": "2026-06-16",
+      "reinforced": 0,
+      "raw_context": "merge to main"
+    },
+    {
+      "rule": "Use that /bmad-quick-dev-teams-reviewed-tdd-v2-srch instead of the repo link I want you to take 2 variable either in teh config file or mcp: github_username and repo_name and then from these I want you to form the url. if the repo doesn't exist I want you to automatically create a new private one with that name obviously return the right error if the github key isn't allowing you to",
+      "why": "",
+      "type": "bugfix",
+      "tags": [
+        "config"
+      ],
+      "scope": "project",
+      "scope_detail": "config",
+      "confidence": 0.75,
+      "created": "2026-06-16",
+      "last_used": "2026-06-16",
+      "reinforced": 0,
+      "raw_context": "instead of the repo link I want you to take 2 variable either in teh config file or mcp: github_username and repo_name and then from these I want you to form the url. if the repo doesn't exist I want you to automatically create a new private one with that name obviously return the right error if the github key isn't allowing you to do that /bmad-quick-dev-teams-reviewed-tdd-v2-srch"
+    },
+    {
+      "rule": "Don't these chnages on a new branch and push with claude-sync afterwards",
+      "why": "",
+      "type": "preference",
+      "tags": [
+        "patterns"
+      ],
+      "scope": "project",
+      "scope_detail": "project-wide",
+      "confidence": 0.8,
+      "created": "2026-06-16",
+      "last_used": "2026-06-16",
+      "reinforced": 0,
+      "raw_context": "modify bmad-quick-dev-teams-reviewed-tdd-v2 and bmad-quick-dev-teams-reviewed-tdd-v2-srch skill so after the plan phase they don't ask for aproval don't do these chnages on a new branch and push with claude-sync afterwards"
+    },
+    {
+      "rule": "merge to main",
+      "why": "",
+      "type": "reinforcement",
+      "tags": [
+        "patterns"
+      ],
+      "scope": "project",
+      "scope_detail": "project-wide",
+      "confidence": 0.75,
+      "created": "2026-06-16",
+      "last_used": "2026-06-16",
+      "reinforced": 0,
+      "raw_context": "merge to main"
+    },
+    {
+      "rule": "I want you to create a feature where you could have presaved settings as to waht you want to save and not save within the same service (branch in repo) that you are backing up. so if the next time you set it up you use the name of the same service in the same repo, what to include and exclude gets overwriten. but you also take in consideration that the path at the beginning may not be the same on all machines /bmad-quick-dev-teams-reviewed-tdd-v2-srch",
+      "why": "",
+      "type": "preference",
+      "tags": [
+        "config"
+      ],
+      "scope": "project",
+      "scope_detail": "project-wide",
+      "confidence": 0.7,
+      "created": "2026-06-16",
+      "last_used": "2026-06-16",
+      "reinforced": 0,
+      "raw_context": "I want you to create a feature where you could have presaved settings as to waht you want to save and not save within the same service (branch in repo) that you are backing up. so if the next time you set it up you use the name of the same service in the same repo, what to include and exclude gets overwriten. but you also take in consideration that the path at the beginning may not be the same on all machines /bmad-quick-dev-teams-reviewed-tdd-v2-srch"
+    },
+    {
+      "rule": "merge to main and push",
+      "why": "",
+      "type": "reinforcement",
+      "tags": [
+        "patterns"
+      ],
+      "scope": "project",
+      "scope_detail": "project-wide",
+      "confidence": 0.75,
+      "created": "2026-06-16",
+      "last_used": "2026-06-16",
+      "reinforced": 0,
+      "raw_context": "merge to main and push"
+    },
+    {
+      "rule": "In a Pydantic v2 BaseModel classmethod, call module-level helper functions directly (func()), never via cls.func()",
+      "why": "Pydantic's ModelMetaclass.__getattr__ intercepts attribute access on the model class and raises AttributeError for any name that is not a private attribute. So cls.<module_func>() fails at runtime even when the function is in module scope. Symptom is a confusing AttributeError pointing at pydantic internals (_model_construction.py), not the call site.",
+      "type": "bugfix",
+      "tags": [
+        "patterns",
+        "backend"
+      ],
+      "scope": "global",
+      "scope_detail": "any Pydantic v2 project",
+      "confidence": 0.9,
+      "created": "2026-06-16",
+      "last_used": "2026-06-16",
+      "reinforced": 0,
+      "raw_context": "TDD caught cls._merge_env_watch raising AttributeError inside syncestra Config.load; the merge helper is module-level, not a classmethod. Plan had written cls._merge_env_watch(merged) — fixed to _merge_env_watch(merged)."
+    }
+  ]
+}

syncestra-1.0.0/.github/workflows/publish.yml

@@ -0,0 +1,42 @@
+name: publish
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v3
+      - name: Build distributions
+        run: uv build
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v3
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Publish to PyPI
+        run: uv publish

syncestra-1.0.0/.gitignore

@@ -0,0 +1,56 @@
+# 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/
+venv/
+env/
+
+# Testing / coverage
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+coverage.xml
+*.cover
+.cache
+
+# Ruff / mypy
+.ruff_cache/
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Type-check
+pyright/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+.DS_Store
+
+# uv
+uv.lock