"#"

examples/devenv.nix

@@ -0,0 +1,36 @@
+# 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: github:org/josh-sync/v1.0.0
+#       flake: true
+#
+# Or in flake.nix:
+#   inputs.josh-sync = {
+#     url = "github:org/josh-sync/v1.0.0";
+#     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 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"
+  '';
+}