@@ -747,7 +747,7 @@ it.layer(NodeServices.layer, { excludeTestServices: true })("InstructionManager"
747747 yield * write ( "repos/app/CLAUDE.md" , "rules" ) ;
748748 yield * onMachine ( home , { ...CLAUDE , registered : [ project ] } , ( { manager } ) =>
749749 Effect . gen ( function * ( ) {
750- yield * manager . share ( { cwd : project , id : "project:claude:CLAUDE.md" } ) ;
750+ yield * manager . share ( { cwd : project , id : "project:claude:CLAUDE.md" , merge : false } ) ;
751751
752752 expect ( yield * read ( "repos/app/AGENTS.md" ) ) . toBe ( "rules" ) ;
753753 expect ( yield * fs . exists ( path . join ( project , "CLAUDE.md" ) ) ) . toBe ( false ) ;
@@ -767,22 +767,22 @@ it.layer(NodeServices.layer, { excludeTestServices: true })("InstructionManager"
767767 yield * onMachine ( home , { ...CLAUDE , registered : [ project ] } , ( { manager } ) =>
768768 Effect . gen ( function * ( ) {
769769 const exists = yield * manager
770- . share ( { cwd : project , id : "project:claude:CLAUDE.md" } )
770+ . share ( { cwd : project , id : "project:claude:CLAUDE.md" , merge : false } )
771771 . pipe ( Effect . flip ) ;
772772 expect ( exists . reason ) . toBe ( "exists" ) ;
773773 expect ( yield * read ( "repos/app/AGENTS.md" ) ) . toBe ( "agents" ) ;
774774 expect ( yield * read ( "repos/app/CLAUDE.md" ) ) . toBe ( "claude" ) ;
775775
776776 const nested = yield * manager
777- . share ( { cwd : project , id : "project:claude:.claude/CLAUDE.md" } )
777+ . share ( { cwd : project , id : "project:claude:.claude/CLAUDE.md" , merge : false } )
778778 . pipe ( Effect . flip ) ;
779779 expect ( nested . reason ) . toBe ( "unknownEntry" ) ;
780780 } ) ,
781781 ) ;
782782 yield * onMachine ( home , CLAUDE , ( { manager } ) =>
783783 Effect . gen ( function * ( ) {
784784 const unregistered = yield * manager
785- . share ( { cwd : project , id : "project:claude:CLAUDE.md" } )
785+ . share ( { cwd : project , id : "project:claude:CLAUDE.md" , merge : false } )
786786 . pipe ( Effect . flip ) ;
787787 expect ( unregistered . reason ) . toBe ( "unregisteredProject" ) ;
788788 } ) ,
@@ -796,7 +796,7 @@ it.layer(NodeServices.layer, { excludeTestServices: true })("InstructionManager"
796796 yield * onMachine ( home , { ...CLAUDE , registered : [ project ] } , ( { manager } ) =>
797797 Effect . gen ( function * ( ) {
798798 const error = yield * manager
799- . share ( { cwd : project , id : "project:claude:CLAUDE.md" } )
799+ . share ( { cwd : project , id : "project:claude:CLAUDE.md" , merge : false } )
800800 . pipe ( Effect . flip ) ;
801801 expect ( error . reason ) . toBe ( "notFound" ) ;
802802 } ) ,
@@ -805,6 +805,140 @@ it.layer(NodeServices.layer, { excludeTestServices: true })("InstructionManager"
805805 ) ;
806806 } ) ;
807807
808+ describe ( "share with merge" , ( ) => {
809+ const CLAUDE_ID = "project:claude:CLAUDE.md" ;
810+
811+ it . effect ( "adds CLAUDE.md's text to the end of AGENTS.md, then deletes CLAUDE.md" , ( ) =>
812+ Effect . gen ( function * ( ) {
813+ const { home, project, write, read, fs, path } = yield * makeMachine ;
814+ yield * write ( "repos/app/AGENTS.md" , "# App\n- Use pnpm." ) ;
815+ yield * write ( "repos/app/CLAUDE.md" , "\n- Run the tests.\n\n" ) ;
816+ yield * onMachine ( home , { ...CLAUDE , registered : [ project ] } , ( { manager } ) =>
817+ Effect . gen ( function * ( ) {
818+ yield * manager . share ( { cwd : project , id : CLAUDE_ID , merge : true } ) ;
819+
820+ expect ( yield * read ( "repos/app/AGENTS.md" ) ) . toBe (
821+ "# App\n- Use pnpm.\n\n- Run the tests.\n" ,
822+ ) ;
823+ expect ( yield * fs . exists ( path . join ( project , "CLAUDE.md" ) ) ) . toBe ( false ) ;
824+ } ) ,
825+ ) ;
826+ } ) ,
827+ ) ;
828+
829+ it . effect ( "takes the line that imports AGENTS.md out of what it adds" , ( ) =>
830+ Effect . gen ( function * ( ) {
831+ const { home, project, write, read } = yield * makeMachine ;
832+ yield * write ( "repos/app/AGENTS.md" , "rules\n" ) ;
833+ yield * write ( "repos/app/CLAUDE.md" , "@AGENTS.md\n\nextra rule\n" ) ;
834+ yield * onMachine ( home , { ...CLAUDE , registered : [ project ] } , ( { manager } ) =>
835+ Effect . gen ( function * ( ) {
836+ yield * manager . share ( { cwd : project , id : CLAUDE_ID , merge : true } ) ;
837+ expect ( yield * read ( "repos/app/AGENTS.md" ) ) . toBe ( "rules\n\nextra rule\n" ) ;
838+ } ) ,
839+ ) ;
840+ } ) ,
841+ ) ;
842+
843+ it . effect (
844+ "only deletes a CLAUDE.md that is just the import, or that AGENTS.md has already" ,
845+ ( ) =>
846+ Effect . gen ( function * ( ) {
847+ const { home, project, write, read, fs, path } = yield * makeMachine ;
848+ yield * write ( "repos/app/AGENTS.md" , "- Use pnpm.\n- Run the tests.\n" ) ;
849+ yield * onMachine ( home , { ...CLAUDE , registered : [ project ] } , ( { manager } ) =>
850+ Effect . gen ( function * ( ) {
851+ for ( const text of [ "@./AGENTS.md\n" , "- Run the tests.\n" , " \n" ] ) {
852+ yield * write ( "repos/app/CLAUDE.md" , text ) ;
853+ yield * manager . share ( { cwd : project , id : CLAUDE_ID , merge : true } ) ;
854+
855+ expect ( yield * read ( "repos/app/AGENTS.md" ) ) . toBe ( "- Use pnpm.\n- Run the tests.\n" ) ;
856+ expect ( yield * fs . exists ( path . join ( project , "CLAUDE.md" ) ) ) . toBe ( false ) ;
857+ }
858+ } ) ,
859+ ) ;
860+ } ) ,
861+ ) ;
862+
863+ it . effect ( "refuses without an AGENTS.md, and leaves CLAUDE.md alone" , ( ) =>
864+ Effect . gen ( function * ( ) {
865+ const { home, project, write, read } = yield * makeMachine ;
866+ yield * write ( "repos/app/CLAUDE.md" , "rules" ) ;
867+ yield * onMachine ( home , { ...CLAUDE , registered : [ project ] } , ( { manager } ) =>
868+ Effect . gen ( function * ( ) {
869+ const error = yield * manager
870+ . share ( { cwd : project , id : CLAUDE_ID , merge : true } )
871+ . pipe ( Effect . flip ) ;
872+ expect ( error . reason ) . toBe ( "notFound" ) ;
873+ expect ( yield * read ( "repos/app/CLAUDE.md" ) ) . toBe ( "rules" ) ;
874+ } ) ,
875+ ) ;
876+ } ) ,
877+ ) ;
878+
879+ it . effect ( "refuses when the result would be over 1 MB, and changes nothing" , ( ) =>
880+ Effect . gen ( function * ( ) {
881+ const { home, project, write, read } = yield * makeMachine ;
882+ yield * write ( "repos/app/AGENTS.md" , "a" . repeat ( 700_000 ) ) ;
883+ yield * write ( "repos/app/CLAUDE.md" , "b" . repeat ( 700_000 ) ) ;
884+ yield * onMachine ( home , { ...CLAUDE , registered : [ project ] } , ( { manager } ) =>
885+ Effect . gen ( function * ( ) {
886+ const error = yield * manager
887+ . share ( { cwd : project , id : CLAUDE_ID , merge : true } )
888+ . pipe ( Effect . flip ) ;
889+ expect ( error . reason ) . toBe ( "tooLarge" ) ;
890+ expect ( ( yield * read ( "repos/app/AGENTS.md" ) ) . length ) . toBe ( 700_000 ) ;
891+ expect ( ( yield * read ( "repos/app/CLAUDE.md" ) ) . length ) . toBe ( 700_000 ) ;
892+ } ) ,
893+ ) ;
894+ } ) ,
895+ ) ;
896+
897+ it . effect . skipIf ( ! symlinksSupported ) (
898+ "writes through a linked AGENTS.md, and removes a CLAUDE.md that is a link without its target" ,
899+ ( ) =>
900+ Effect . gen ( function * ( ) {
901+ const { home, project, write, link, read, fs, path } = yield * makeMachine ;
902+ yield * write ( "dotfiles/app-agents.md" , "rules\n" ) ;
903+ yield * write ( "dotfiles/app-claude.md" , "more rules\n" ) ;
904+ yield * link ( "dotfiles/app-agents.md" , "repos/app/AGENTS.md" ) ;
905+ yield * link ( "dotfiles/app-claude.md" , "repos/app/CLAUDE.md" ) ;
906+ yield * onMachine ( home , { ...CLAUDE , registered : [ project ] } , ( { manager } ) =>
907+ Effect . gen ( function * ( ) {
908+ yield * manager . share ( { cwd : project , id : CLAUDE_ID , merge : true } ) ;
909+
910+ // The text lands in the real file, so AGENTS.md is still a link to it.
911+ expect ( yield * read ( "dotfiles/app-agents.md" ) ) . toBe ( "rules\n\nmore rules\n" ) ;
912+ expect ( yield * fs . readLink ( path . join ( project , "AGENTS.md" ) ) ) . toBe (
913+ path . join ( home , "dotfiles/app-agents.md" ) ,
914+ ) ;
915+ expect ( yield * fs . exists ( path . join ( project , "CLAUDE.md" ) ) ) . toBe ( false ) ;
916+ expect ( yield * read ( "dotfiles/app-claude.md" ) ) . toBe ( "more rules\n" ) ;
917+ } ) ,
918+ ) ;
919+ } ) ,
920+ ) ;
921+
922+ it . effect . skipIf ( ! symlinksSupported ) (
923+ "won't delete a CLAUDE.md that the project's AGENTS.md is a link to" ,
924+ ( ) =>
925+ Effect . gen ( function * ( ) {
926+ const { home, project, write, link, read } = yield * makeMachine ;
927+ yield * write ( "repos/app/CLAUDE.md" , "rules" ) ;
928+ yield * link ( "repos/app/CLAUDE.md" , "repos/app/AGENTS.md" ) ;
929+ yield * onMachine ( home , { ...CLAUDE , registered : [ project ] } , ( { manager } ) =>
930+ Effect . gen ( function * ( ) {
931+ const error = yield * manager
932+ . share ( { cwd : project , id : CLAUDE_ID , merge : true } )
933+ . pipe ( Effect . flip ) ;
934+ expect ( error . reason ) . toBe ( "exists" ) ;
935+ expect ( yield * read ( "repos/app/CLAUDE.md" ) ) . toBe ( "rules" ) ;
936+ } ) ,
937+ ) ;
938+ } ) ,
939+ ) ;
940+ } ) ;
941+
808942 describe ( "adopt" , ( ) => {
809943 it . effect . skipIf ( ! symlinksSupported ) (
810944 "adds the agent's text to the shared file under its name, then links the agent to it" ,
0 commit comments