Import josh-sync from subrepo/main

Sync-Origin: import/josh-sync/20260528-041502

examples/devenv.nix

@@ -0,0 +1,38 @@
+# Consumer devenv.nix example
+# Add josh-sync as a flake input in your devenv.yaml or flake.nix,
+# then import the module here.
+#
+# In devenv.yaml:
+#   inputs:
+#     josh-sync:
+#       url: git+https://your-gitea.example.com/org/josh-sync?ref=refs/tags/v1.2
+#       flake: true
+#
+# Or in flake.nix:
+#   inputs.josh-sync = {
+#     url = "git+https://your-gitea.example.com/org/josh-sync?ref=refs/tags/v1.2";
+#     inputs.nixpkgs.follows = "nixpkgs";
+#   };
+
+{ inputs, pkgs, ... }:
+
+{
+  imports = [ inputs.josh-sync.devenvModules.default ];
+
+  # josh-sync CLI is now available in the shell.
+  # Commands:
+  #   josh-sync sync --forward         Forward sync (mono → subrepo)
+  #   josh-sync sync --reverse         Reverse sync (subrepo → mono)
+  #   josh-sync preflight              Validate config and connectivity
+  #   josh-sync import <target>        Initial import from subrepo
+  #   josh-sync reset <target>         Reset subrepo to josh-filtered view
+  #   josh-sync onboard <target>       Interactive import + reset workflow
+  #   josh-sync migrate-pr <target>    Migrate PRs from archived repo
+  #   josh-sync status                 Show target config and sync state
+  #   josh-sync state show <t> [b]     Show state JSON
+  #   josh-sync state reset <t> [b]    Reset state
+
+  enterShell = ''
+    echo "Josh Sync available — run 'josh-sync --help' for commands"
+  '';
+}